Сделайте первый запрос к API
Создайте ключ API ShareAI, выберите доступную модель и отправьте запрос чата с вашего сервера с аутентификацией Bearer.
На этой странице
Начните здесь, если ваше приложение будет отправлять запросы с использованием ключа API из вашего рабочего пространства ShareAI. Вам потребуется учетная запись ShareAI, активный ключ и доступ к модели, которую вы хотите запустить.
1. Создать ключ API#
Открыть Консоль ShareAI и выберите рабочее пространство, которому будет принадлежать ключ и использование. Откройте Ключи API, выберите Создать ключ API, дайте ключу узнаваемое имя и сохраните секрет в среде вашего сервера.
2. Выбрать модель#
Открыть Модели и скопируйте точный идентификатор модели, указанный там. Проверьте текущую доступность и ограничения модели/провайдера для вашего ключа. Идентификатор из старого руководства не гарантирует доступность мощности сегодня.
3. Отправить запрос#
https://api.shareai.now/api/v1/chat/completionsСгенерируйте ответ, используя доступную модель.
- Базовый URL
https://api.shareai.now- Аутентификация
- Ключ API Bearer
Заменить MODEL_IDENTIFIER с выбранным вами идентификатором. Установите SHAREAI_API_KEY в вашей среде перед запуском примера.
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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], '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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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());
4. Прочитать результат#
Для успешного запроса без потоковой передачи убедитесь, что значение done равно true, и прочитайте сообщение помощника из message.content. Проверьте как HTTP-статус, так и любой объект ошибки в теле перед тем, как считать это успешным завершением. Результат "нет устройства" может прийти как объект ошибки с HTTP 200.
Если запрос не удался#
| Статус | Следующий шаг |
|---|---|
| 401 | Проверьте ключ, рабочее пространство и заголовок Authorization. |
| 402 | Проверьте доступные кредиты или применимый баланс. |
| 403 | Проверьте разрешенные модели и провайдеров. |
| 429 | Дождитесь Retry-After, если он присутствует, затем повторите с ограниченной задержкой. |
| 503 | Проверьте текущую мощность или доступность сервиса; установите лимит повторных попыток. |
Следующие шаги#
Справочник запросов и ответов чата объясняет поддерживаемое тело. Если каждый клиент должен авторизовать свою учетную запись, следуйте OAuth приложения.
Идентификация модели и провайдеры выполнения#
Скопируйте точный идентификатор модели, основанный на создателе, из Модели. Выберите инфраструктуру отдельно с необязательным provider объектом. По умолчанию ранжирование подходящих провайдеров осуществляется по цене, начиная с самой низкой. Выберите провайдеров или ознакомьтесь с полным справочником политики.
Последнее обновление Сентябрь 16, 2026