Перейти к статье
ДокументацияПоддержка

Chat Completions

Основной формат для диалогов и генерации текста.

Копировать и скачать
Все руководства (.md)

Тело запроса

json
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
streamtrue для получения ответа частями
max_tokens / max_output_tokensМаксимальная длина ответа
temperatureСтепень вариативности, если модель поддерживает
toolsJSON-схемы функций, доступных модели
tool_choiceАвтоматический или принудительный выбор функции
response_formatТребуемый формат ответа, если поддерживается

Вызов функций

Передайте список tools с JSON Schema аргументов. Если модель вернула tool_calls, выполните функцию в своём приложении, добавьте результат сообщением role: tool и отправьте историю повторно.

json
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}

Текст и изображение на входе

Для vision-модели content сообщения может быть массивом частей. Изображение передавайте публичной HTTPS-ссылкой либо data URL; закрытая ссылка с cookie серверу недоступна.

json
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}

Формат ответа

Пример обмена · переключайте запрос и ответ вручную

HTTP
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].

bash
1curl -N https://elysiumai.net/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Передача ответа частями сразу по мере готовности.

Документация

Мастер подключенияНастроить IDE за минуту