Справочник API

Chat Completions

POST/v1/chat/completions

Основной эндпоинт: многоходовой чат, потоковая передача, вызов инструментов, распознавание изображений и JSON-режим для всех чат-моделей каталога.

#Параметры запроса

  • modelstringобязательно

    ID модели из /v1/models. По этому значению шлюз определяет вышестоящего провайдера.

  • messagesarrayобязательно

    Реплики диалога: {role: system|user|assistant|tool, content}. content может быть строкой или массивом мультимодальных частей.

  • streambooleanнеобязательно

    true включает поток SSE-дельт, который завершается data: [DONE].

  • temperaturenumberнеобязательно

    От 0 до 2. Оставьте пустым, чтобы использовать значение модели по умолчанию.

  • max_tokensintegerнеобязательно

    Максимум генерируемых токенов; также ограничивает предварительно резервируемую квоту.

  • toolsarrayнеобязательно

    Объявления функций, которые может вызвать модель, — см. руководство по вызову инструментов.

  • tool_choicestring | objectнеобязательно

    "auto", "none" или конкретная функция.

  • response_formatobjectнеобязательно

    {"type":"json_object"} или обёртка json_schema для структурированного вывода на поддерживающих моделях.

  • top_pnumberнеобязательно

    Nucleus sampling; задавайте temperature или top_p, но не оба сразу.

  • stopstring | arrayнеобязательно

    До 4 стоп-последовательностей, прерывающих генерацию.

#Связанные ошибки

  • 400 invalid_request_errorНекорректное тело или параметр, который эта модель не поддерживает.
  • 401Bearer-токен недействителен или отсутствует. На этом пути error.code нет — ориентируйтесь на статус.
  • 402 insufficient_user_quotaБаланса кошелька не хватает на предварительно резервируемую сумму.
  • 429Ограничение частоты для ключа. Тело пустое; дождитесь Retry-After. Если же в ответе 429 есть insufficient_user_quota, это дневной лимит расходов.
  • 503 model_not_foundНеизвестная модель, или сейчас её не обслуживает ни один исправный канал.

Полная таблица кодов ошибок →

#Пример запроса

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Ответ

response.json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.