Тело запроса
1{2 "model": "your-model-id",3 "messages": [4 {"role": "system", "content": "Отвечай кратко."},5 {"role": "user", "content": "Что такое API?"}6 ],7 "temperature": 0.4,8 "max_tokens": 300,9 "stream": false10}Главные поля
| Поле | Описание |
|---|---|
| model | Точный ID из каталога |
| messages | История сообщений с ролями system, user, assistant и tool |
| stream | true для получения ответа частями |
| max_tokens / max_output_tokens | Максимальная длина ответа |
| temperature | Степень вариативности, если модель поддерживает |
| tools | JSON-схемы функций, доступных модели |
| tool_choice | Автоматический или принудительный выбор функции |
| response_format | Требуемый формат ответа, если поддерживается |
Вызов функций
Передайте список tools с JSON Schema аргументов. Если модель вернула tool_calls, выполните функцию в своём приложении, добавьте результат сообщением role: tool и отправьте историю повторно.
1{2 "model": "your-model-id",3 "messages": [{"role": "user", "content": "Какая погода в Москве?"}],4 "tools": [{5 "type": "function",6 "function": {7 "name": "get_weather",8 "description": "Получить текущую погоду",9 "parameters": {10 "type": "object",11 "properties": {"city": {"type": "string"}},12 "required": ["city"]13 }14 }15 }]16}Наличие поля tools в API не означает, что его понимает каждая модель. Проверяйте поддерживаемые endpoints и возможности карточки модели.
Текст и изображение на входе
Для vision-модели content сообщения может быть массивом частей. Изображение передавайте публичной HTTPS-ссылкой либо data URL; закрытая ссылка с cookie серверу недоступна.
1{2 "model": "your-vision-model-id",3 "messages": [{4 "role": "user",5 "content": [6 {"type": "text", "text": "Что изображено?"},7 {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}8 ]9 }]10}Формат ответа
Пример обмена · переключайте запрос и ответ вручную
1POST /v1/chat/completions2Authorization: Bearer sk-...3Content-Type: application/json4 5{6 "model": "your-model-id",7 "messages": [8 {"role": "user", "content": "Привет!"}9 ]10}Потоковый ответ
Установите stream: true, чтобы получать фрагменты ответа по мере генерации. Каждый фрагмент приходит как Server-Sent Event, а завершение потока обозначается строкой [DONE].
1curl -N https://elysiumai.garden/v1/chat/completions -H "Authorization: Bearer $ELYSIUM_API_KEY" -H "Content-Type: application/json" -d '{"model":"your-model-id","stream":true,"messages":[{"role":"user","content":"Привет"}]}'Термины на этой странице
| Термин | Что означает |
|---|---|
| Base URL | Базовый адрес API, к которому клиент добавляет нужный маршрут. |
| API-ключ | Секрет для авторизации и списания запросов с вашего баланса. |
| Model ID | Точное системное имя модели из каталога Elysium AI. |
| Endpoint | Маршрут, определяющий выполняемую API-операцию. |
| JSON | Текстовый формат структуры запроса и ответа. |
| Usage | Объект ответа со счётчиками использованных ресурсов. |
| Streaming | Передача ответа частями сразу по мере готовности. |