Ваши идеи.
Наш API.

Текстовые модели

Выберите включённую текстовую модель из GET /v1/models. ID в примерах показывают формат запроса; их наличие в справочнике не означает, что модель сейчас доступна. GPT-модели вызывайте через Responses или Chat Completions. Messages подходит для Claude и совместимых моделей. Возможности vision, tools, JSON Schema и reasoning зависят от выбранной модели и не становятся доступными при смене протокола.

GPT-5.6 Luna

gpt-5.6-luna принимает текст и изображения, возвращает текст. Используйте POST /v1/responses с input либо POST /v1/chat/completions с messages; /v1/messages для этой модели не поддерживается. Изображения: input_image в Responses, image_url в Chat; подходят публичные HTTPS URL и data URL.

reasoning.effort в Responses или reasoning_effort в Chat: low, medium, high, xhigh, max; по умолчанию medium. Контекст 1 050 000 токенов, вход до 922 000, вывод до 128 000. Reasoning-токены входят в лимит вывода и оплачиваются как выходные.

service_tier — необязательная строка. Опустите её для стандартного режима. Значения priority или fast включают Fast: все опубликованные рублёвые тарифы этой модели умножаются на 2, включая вход, выход, чтение и запись кэша. Это правило относится к Luna; наличие Fast у другой модели проверяйте отдельно.

GLM-5.3 Flash

Для glm-5.3-flash используйте POST /v1/chat/completions. Модель принимает текст и изображения image_url с публичными HTTPS URL или data URL и возвращает текст. Контекст 1 000 000 токенов, вывод до 128 000. Thinking всегда включён; reasoning_effort: high или max, по умолчанию max. low и medium выполняются как high, xhigh — как max. service_tier не поддерживается: опустите его.

Responses и Messages доступны через преобразование в Chat Completions с ограничениями. В Responses передавайте текст или input_image; input_file не переносится. В Messages поддерживаются текст, tool-блоки и изображения только в base64; изображения по URL не переносятся. Web search и другие серверные инструменты при обоих преобразованиях не поддерживаются. reasoning.effort в Responses использует те же уровни. В Messages явно задавайте output_config.effort: без него передаётся medium, который модель выполняет как high.

Все три метода принимают JSON и требуют Authorization: Bearer, Content-Type: application/json и уникальный Idempotency-Key для каждой новой операции. В примерах API_BASE — указанный выше адрес без /v1 в конце, API_KEY — ваш ключ. Создайте REQUEST_KEY один раз, сохраните вместе с телом запроса; повтор той же операции использует тот же ключ. Для нового запроса создайте новый ключ.

REQUEST_KEY="$(python3 -c 'import uuid; print(uuid.uuid4())')"

Лимиты и возможности текстовых моделей

Проверено 28.09.2026. Здесь перечислены объявленные технические параметры, а не обещание доступности всех ID: работающая модель должна присутствовать в GET /v1/models. Контекст включает вход и вывод вместе; максимумы входа и вывода не всегда достижимы одновременно. Системные инструкции, история, инструменты и рассуждения также используют токены. Не объявлено означает, что подтверждённого значения нет; это не ноль, не отсутствие ограничения и не поддержка функции. API проверяет общий формат, а конкретная модель может отклонить превышение своего лимита.

Следующая таблица отдельно показывает перечисленные уровни, дополнительные значения и объявленную настройку по умолчанию. Отсутствие default не означает medium. Для GPT с default=none не подменяйте отсутствие параметра произвольно выбранным уровнем. Способ передачи effort зависит от протокола и описан ниже. Отдельные правила GLM/Kimi приведены в разделе Reasoning / thinking.

Claude Opus 5: отключение thinking допускается только при effort high или ниже. Claude Fable 5.1: не используйте принудительный tool_choice any/tool. Claude Sonnet 5: оставьте temperature, top_p и top_k неуказанными — произвольное изменение этих настроек не поддерживается. Для deepseek-v4-flash-vision-exp, deepseek-v4-pro-0813 и gpt-5.3-codex-spark текущие пределы не подтверждены; значения и настройки других ID на них автоматически не распространяются.

POST /v1/responses

curl --fail-with-body -sS -N "$API_BASE/v1/responses" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "gpt-5.6-sol",
  "input": "Explain a database transaction in two sentences.",
  "max_output_tokens": 512
}'

HTTP 200: читайте output[] и собирайте блоки content[] с type=output_text. Массив может также содержать reasoning и function_call. Не привязывайте извлечение текста к одному индексу. status=incomplete означает частичный результат; проверяйте incomplete_details.

{
  "id": "8488e6a4-d38a-4f95-a831-752aa12bf5d7",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Ready."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 3,
    "total_tokens": 15
  }
}

POST /v1/chat/completions

curl --fail-with-body -sS -N "$API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "glm-5.3",
  "messages": [
    {
      "role": "user",
      "content": "Explain a database transaction in two sentences."
    }
  ],
  "max_completion_tokens": 2048,
  "reasoning_effort": "low"
}'

HTTP 200: текст находится в choices[].message.content, вызовы функций — в message.tool_calls, причина завершения — finish_reason. length означает достижение лимита и возможный обрыв текста.

{
  "id": "8488e6a4-d38a-4f95-a831-752aa12bf5d7",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Ready."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 3,
    "total_tokens": 15
  }
}

POST /v1/messages

Передайте anthropic-version: 2023-06-01. Вместо Bearer допускается x-api-key с вашим ключом, если Authorization отсутствует. Дополнительный anthropic-beta используйте только для подтверждённой возможности выбранной модели.

curl --fail-with-body -sS -N "$API_BASE/v1/messages" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  --data '{
  "model": "claude-sonnet-5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Explain a database transaction in two sentences."
    }
  ]
}'

HTTP 200: content[] содержит text, tool_use и другие блоки модели. Читайте все text-блоки; stop_reason=max_tokens указывает на ограниченный вывод, stop_reason=tool_use — на запрос инструмента. Здесь счётчики usage называются input_tokens и output_tokens.

{
  "id": "8488e6a4-d38a-4f95-a831-752aa12bf5d7",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ready."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 3
  }
}

Инструменты и JSON Schema

Ниже тела запросов к соответствующим методам; заголовки те же. Приложение выполняет функцию само после проверки её аргументов и разрешений. Результат отправляйте следующим запросом с новым Idempotency-Key. В Responses это input-элемент type=function_call_output с call_id и строкой output; в Chat — сообщение role=tool с tool_call_id и строкой content после сообщения assistant с tool_calls; в Messages — user-блок type=tool_result с tool_use_id и content после assistant-блока tool_use. Сохраняйте исходные идентификаторы вызовов и историю.

responses — tools

{
  "model": "gpt-5.6-sol",
  "input": "Check order A123 using the available tool.",
  "max_output_tokens": 512,
  "tools": [
    {
      "type": "function",
      "name": "get_order",
      "description": "Read an order status.",
      "parameters": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "order_id"
        ],
        "additionalProperties": false
      },
      "strict": true
    }
  ],
  "tool_choice": "auto"
}

chat/completions — tools

{
  "model": "gpt-5.6-sol",
  "messages": [
    {
      "role": "user",
      "content": "Check order A123 using the available tool."
    }
  ],
  "max_completion_tokens": 512,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_order",
        "description": "Read an order status.",
        "parameters": {
          "type": "object",
          "properties": {
            "order_id": {
              "type": "string"
            }
          },
          "required": [
            "order_id"
          ],
          "additionalProperties": false
        }
      }
    }
  ],
  "tool_choice": "auto"
}

messages — tools

{
  "model": "claude-sonnet-5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "Check order A123 using the available tool."
    }
  ],
  "tools": [
    {
      "name": "get_order",
      "description": "Read an order status.",
      "input_schema": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "order_id"
        ]
      }
    }
  ],
  "tool_choice": {
    "type": "auto"
  }
}

Для строгой схемы все обязательные свойства перечислены в required; additionalProperties=false запрещает лишние поля. Валидируйте JSON в приложении и обрабатывайте отказ модели или достижение лимита токенов. Поддержка structured output не следует только из принятия поля API.

responses — JSON Schema

{
  "model": "gpt-5.6-sol",
  "input": "Return the word ready in a status field.",
  "max_output_tokens": 512,
  "text": {
    "format": {
      "type": "json_schema",
      "name": "status_result",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "additionalProperties": false
      }
    }
  }
}

chat/completions — JSON Schema

{
  "model": "gpt-5.6-sol",
  "messages": [
    {
      "role": "user",
      "content": "Return the word ready in a status field."
    }
  ],
  "max_completion_tokens": 512,
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "status_result",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "additionalProperties": false
      }
    }
  }
}

Изображение в текстовом запросе

Используйте только vision-модель. Замените https://example.com/reference.jpg на прямую доступную HTTPS-ссылку на изображение. Base64 также зависит от модели: в Responses input_image.image_url и Chat image_url.url передают data:image/jpeg;base64,...; в Messages используют source с type=base64, media_type=image/jpeg и data с чистым base64. Для Kimi K3 используйте base64 data URL. Максимальный размер/число изображений и поддержка файлов и аудио не являются общими для всех текстовых моделей.

responses — vision

{
  "model": "gpt-5.6-sol",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Describe the image."
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/reference.jpg"
        }
      ]
    }
  ],
  "max_output_tokens": 512
}

chat/completions — vision

{
  "model": "gpt-5.6-sol",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Describe the image."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.jpg"
          }
        }
      ]
    }
  ],
  "max_completion_tokens": 512
}

messages — vision

{
  "model": "claude-sonnet-5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Describe the image."
        },
        {
          "type": "image",
          "source": {
            "type": "url",
            "url": "https://example.com/reference.jpg"
          }
        }
      ]
    }
  ]
}

Видео в Qwen3.8-Max

Оригинальная модель Qwen3.8-Max понимает видео, но текущий маршрут Нейроныча принимает для неё только текст и изображения. Блоки video_url, input_video и video отклоняются с HTTP 422 invalid_request_contract и заголовком X-Validation-Error: video_input_unavailable до создания задачи и оплаты. Не заменяйте видео кадрами без явного выбора такого режима. Для текстовых запросов обязательно указывайте Idempotency-Key длиной от 8 до 160 символов.

Reasoning / thinking

Для GLM и Kimi управляйте reasoning_effort через Chat Completions. Таблица описывает настройку при доступности соответствующей модели; уровни не универсальны. GPT использует reasoning.effort в Responses или reasoning_effort в Chat. У Claude thinking и output_config зависят от поколения; без подтверждённой конфигурации опустите их. HTTP 200 не подтверждает, что произвольная неподдерживаемая настройка повлияла на результат.

curl --fail-with-body -sS -N "$API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": "List three checks before saving a payment."
    }
  ],
  "max_completion_tokens": 2048,
  "reasoning_effort": "low",
  "stream": true
}'

SSE / stream=true

Успешный поток имеет Content-Type: text/event-stream и X-Request-Id. События разделяются пустой строкой; граница сетевого чанка не является границей события. Собирайте data: до конца события, затем разбирайте JSON. Обрабатывайте event:, служебные блоки и ошибки; при [DONE] JSON-парсер не вызывается. Иллюстрации ниже сокращены: токены usage и текст приведены только как пример.

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Ready."}

event: response.completed
data: {"type":"response.completed","response":{"id":"8488e6a4-d38a-4f95-a831-752aa12bf5d7","status":"completed","usage":{"input_tokens":12,"output_tokens":3}}}

Responses: собирайте response.output_text.delta.delta; конец — response.completed или response.incomplete. Последний означает частичный результат. Function-call arguments приходят отдельными событиями; их тоже нужно собрать до разбора JSON.

data: {"choices":[{"index":0,"delta":{"content":"Ready."},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"choices":[],"usage":{"prompt_tokens":12,"completion_tokens":3,"total_tokens":15}}

data: [DONE]

Chat: объединяйте choices[].delta по index; content и tool_calls могут приходить частями. Не заканчивайте чтение сразу на finish_reason: после него может идти usage с пустым choices.

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Ready."}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":3}}

event: message_stop
data: {"type":"message_stop"}

Messages: обработайте message_start, content_block_start/delta/stop, message_delta и message_stop; text_delta.text — текст, input_json_delta.partial_json — часть аргументов инструмента. Счётчики usage могут находиться в нескольких событиях.

Сохраните X-Request-Id для обращения в поддержку. Разрыв потока или клиентский таймаут не означает отмену запроса: частичный текст не подтверждает успешное завершение. Не создавайте новую платную операцию автоматически при обрыве. Повтор синхронного запроса с тем же ключом возвращает 409 request_already_submitted, а не сохранённый текст. Описание ошибок — в общем разделе.

wan-3

2–30 сек; 480p / 720p / 1080p; до 10 изображений, 5 видео, 5 аудио, всего 20. Промпт обязателен, до 20000 символов. Первый/последний кадр и edit поддерживаются. В edit не передавайте duration, aspect_ratio, size: размеры берутся из первого видео. Поддерживаются seed от 0 до 4294967295 и generate_audio: false.

POST /v1/videos/generations
{
  "model": "wan-3",
  "prompt": "A slow camera move around a ceramic cup",
  "duration": 5,
  "resolution": "720p",
  "generate_audio": false,
  "seed": 42
}

POST /v1/videos/generations
{
  "model": "wan-3",
  "prompt": "Make the colors in @Video 1 warmer",
  "omni_reference_task_type": "edit",
  "resolution": "720p",
  "reference_videos": [
    {
      "url": "https://media.example.com/source.mp4"
    }
  ]
}

Референсы передаются как HTTPS URL. Предварительного удержания с партнёрского баланса нет. Списание выполняется после успешной генерации по подтверждённым usage.billed_seconds. Изображения и аудио отдельно не оплачиваются. Один запрос — одно видео. Сохраняйте request_id из HTTP 202, опрашивайте GET /v1/videos/{request_id}; при done скачайте /v1/videos/{request_id}/content. Не повторяйте POST с новым ключом при задержке.

Входные клипы: 1–15 сек, до 15 сек суммарно. Результат и видеореференсы вместе: до 30 сек.

wan-3-prime

4–30 сек; 480p / 720p / 1080p; до 10 изображений, 5 видео, 5 аудио, всего 20. Промпт обязателен, до 20000 символов. Пропорции: 16:9, 1:1, 9:16. Первый/последний кадр, edit, seed, adaptive и отключение звука не поддерживаются. Аудиореференс требует изображение или видео.

POST /v1/videos/generations
{
  "model": "wan-3-prime",
  "prompt": "Animate the subject in @Image 1",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "reference_images": [
    {
      "url": "https://media.example.com/reference.jpg"
    }
  ]
}

Референсы передаются как HTTPS URL. Предварительного удержания с партнёрского баланса нет. Списание выполняется после успешной генерации по подтверждённым usage.billed_seconds. Изображения и аудио отдельно не оплачиваются. Один запрос — одно видео. Сохраняйте request_id из HTTP 202, опрашивайте GET /v1/videos/{request_id}; при done скачайте /v1/videos/{request_id}/content. Не повторяйте POST с новым ключом при задержке.

Входные клипы: 1–15 сек, до 15 сек суммарно. Результат и видеореференсы вместе: до 30 сек.