Создать текстовый ответ
Используйте API ответов ShareAI для генерации текста без сохранения состояния, явной истории разговоров и событий потоковой передачи ответов.
На этой странице
https://api.shareai.now/api/v1/responsesСгенерируйте текстовый ответ из подсказки или разговора.
- Базовый URL
https://api.shareai.now- Аутентификация
- Bearer API-ключ или утвержденный токен доступа OAuth
Выберите этот API, если ваше приложение использует формат текстовых сообщений Ответов. Указывайте разговор в каждом запросе; ответы не сохраняются для последующего извлечения.
Отправить запрос#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/responses" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Поля запроса#
| Поле | Значение |
|---|---|
model | Доступная модель для чатов, разрешенная вашими учетными данными. |
input | Непустая строка или до 256 текстовых сообщений. |
instructions | Необязательные системные инструкции, добавляемые перед разговором. |
store | false; сохранение ответов не поддерживается. |
stream | false для JSON или true для событий SSE Ответов. |
Продолжить разговор#
Отправьте предыдущие сообщения input вместе со следующим сообщением пользователя. Поддерживаемые роли: user, assistant, system и developer. Инструкции разработчика используют системную роль внутренне. Содержимое сообщения может быть текстом или input_text/output_text частями.
JSON
{
"model": "YOUR_CHAT_MODEL",
"input": [
{
"role": "user",
"content": "What is semantic search?"
},
{
"role": "assistant",
"content": "It finds results by meaning rather than exact words."
},
{
"role": "user",
"content": "Give one example."
}
],
"store": false
}
Прочитать результат#
JSON-ответ является response объектом. Прочитайте текст помощника из output[].content[] записей с типом output_text. Проверьте статус ответа: completed завершенный ответ; incomplete может указывать на лимит токенов. Публичный usage в настоящее время null; используйте Консоль использования для проверки обработанного использования.
Потоковый ответ#
Установите stream: true и анализируйте SSE. События включают response.created, response.output_text.delta и терминальный response.completed, response.incomplete или response.failed. Добавляйте текстовые дельты по порядку и обрабатывайте терминальный статус явно.
Поддерживаемый подмножество#
Эта конечная точка поддерживает генерацию текста. Сохраненные ответы, previous_response_id, извлечение/удаление, инструменты, ввод изображений, фоновые запросы и настройки генерации, такие как temperature не поддерживаются и отклоняются. Для настроек генерации на основе сообщений, поддерживаемых Chat Completions, используйте Завершения чата.
Используйте токен доступа OAuth#
Замените ключ API в заголовке Authorization на утвержденный OAuth токен доступа. surcharge Требуются область действия и утвержденный план использования для финансируемого аккаунтом вывода. Области действия, связанные только с идентификацией, не разрешают расходы. См. области действия и разрешения.
Последнее обновление Сентябрь 15, 2026