Создайте завершение чата
Отправьте запрос на завершение чата ShareAI с ключом API Bearer и ознакомьтесь с поддерживаемой моделью, сообщениями и полями потока.
На этой странице
https://api.shareai.now/api/v1/chat/completionsВыполните запрос чата, используя выбранную модель.
- Базовый URL
https://api.shareai.now- Аутентификация
- Ключ API Bearer
Это путь интеграции по умолчанию для запросов, оплаченных и авторизованных вашим рабочим пространством API-ключа. Ограничения ключа по модели и провайдеру применяются к распределению, включая разрешенные резервные пути.
Тело запроса#
| Поле | Тип | Значение |
|---|---|---|
model | строка, обязательно | Точный идентификатор доступной модели. Скопируйте его из Моделей. |
messages | массив | Сообщения разговора, содержащие роль и содержание. |
stream | булево | false возвращает один результат JSON; true запрашивает события, отправляемые сервером. |
Используйте текстовое содержание сообщения. Отправляйте роли, такие как system, user и assistant в соответствии с разговором. Включите историю разговора, которую вы хотите, чтобы модель использовала; не предполагайте, что запросы используют сохраненный разговор.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, 'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', 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/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
Ответ#
Завершенный результат без потоковой передачи устанавливает done в true и возвращает сгенерированный текст на message.content. Верхний уровень также содержит done_reason и consumption_type. Потоковая передача использует другой формат, chat-completion-chunk. Не предполагайте, что результат без потоковой передачи имеет массив выбора в стиле OpenAI.
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
Это иллюстративный завершенный результат; consumption_type описывает фактический режим распределения. Проверьте наличие ошибки верхнего уровня, даже если HTTP-статус равен 200. Результат без устройства в настоящее время использует error.code = no_device с HTTP 200.
Ограничения модели и провайдера#
Ключ может быть ограничен определенными моделями и провайдерами выполнения. Если доступ запрещен, проверьте информацию о ключе и обновите ключ в Консоли только если рабочее пространство владельца намерено предоставить этот доступ.
Потоковая передача или авторизация клиента#
Потоковый ответ · Используйте токен доступа OAuth
Идентификация модели и провайдеры выполнения#
Скопируйте точный идентификатор модели, основанный на создателе, из Модели. Выберите инфраструктуру отдельно с необязательным provider объектом. По умолчанию ранжирование подходящих провайдеров осуществляется по цене, начиная с самой низкой. Выберите провайдеров или ознакомьтесь с полным справочником политики.
Последнее обновление Сентябрь 16, 2026