Скоро · предварительная инструкция
Chat Completions: текст и диалоги
Структура сообщений и получение ответа модели.
Готовимся к запуску API
Каталог и цены уже доступны. Подключение и генерация готовятся. Инструкции с отметкой «Скоро» описывают подготовку: окончательные настройки будут подтверждены при запуске.
Как это устроено
Запрос состоит из model и массива messages. Сообщение system задаёт правила, user содержит вопрос, assistant хранит предыдущий ответ. Передавайте только ту историю, которая нужна для текущей задачи.
Порядок работы
- Сначала отправьте один вопрос без длинной истории.
- Задайте max_tokens, чтобы ограничить длину результата.
- Извлеките текст из choices[0].message.content и отдельно сохраните usage.
Пример для подготовки
Адрес TOKENMOST_BASE_URL должен включать /v1. Подставьте подтверждённый адрес после запуска API, ключ проекта и точный ID модели. Сейчас этот пример не выполняет запросы к публичному сайту.
curl "$TOKENMOST_BASE_URL/chat/completions" \
-H "Authorization: Bearer $TOKENMOST_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: example-request-0001" \
-d '{
"model": "MODEL_ID_FROM_CATALOG",
"messages": [{"role": "user", "content": "Объясни API в двух предложениях."}],
"max_tokens": 128
}'Что учесть
История не возникает автоматически: приложение собирает её само. До публичного запуска пример служит подготовкой интеграции.