Начало
Матрица совместимости
Поддерживаемые параметры, форматы и границы совместимости API.
| Операция | Endpoint | Клиент / формат | Ограничения |
|---|---|---|---|
| Chat | POST /v1/chat/completions | OpenAI JS SDK 7.13.0 | Текст, изображения на входе (image_url со ссылкой kvantora-file:<id> на свой файл PNG, JPEG или WebP до 10 МиБ), function tools, text/json_object, reasoning_effort; SSE при доступной потоковой операции. Принимаются поля OpenAI SDK: max_completion_tokens (синоним max_tokens; разные значения вместе — 400) и stream_options.include_usage (итог usage и billing всегда приходит в последнем чанке); reasoning.max_tokens только уменьшает серверный предел рассуждений. Ответ без потока от модели с рассуждением может идти до 120 с |
| Оценка чата | POST /v1/chat/quote | JSON Kvantora | Тело как у chat/completions; оценка резерва без вызова модели и списания |
| Responses | POST /v1/responses | OpenAI JS SDK 7.13.0 | Stateless, только текст, stream=false, store=false |
| Messages | POST /v1/messages | Anthropic JS SDK 0.124.0 | Stateless, только текст, обязательный max_tokens, stream=false |
| Embeddings | POST /v1/embeddings | OpenAI JS SDK 7.13.0 | 1–16 строк по 8192 символа; dimensions 1–4096; float/base64 |
| Ранжирование | POST /v1/rerank | JSON Kvantora | query до 16 КиБ, 1–1000 документов до 64 КиБ каждый, весь запрос до 1 МиБ; top_n, return_documents; синхронный ответ |
| Изображения | POST /v1/images/generations | JSON Kvantora | n от 1 до 16, если модель это поддерживает; настройки модели в settings; асинхронный JSON, файлы результата в output.files |
| Редактирование | POST /v1/images/edits | JSON Kvantora | Свой проверенный image file_id; JSON, без multipart |
| Видео | POST /v1/videos | JSON Kvantora | Асинхронное задание |
| Озвучивание | POST /v1/audio/speech | JSON Kvantora | Поле input, асинхронное задание |
| Транскрипция | POST /v1/audio/transcriptions | JSON Kvantora | Свой audio file_id; результат TXT |
| MCP | POST /mcp | Официальный SDK 1.30.0 | Stateless Streamable HTTP, tools/list и tools/call |
Responses не принимает previous_response_id, hosted tools, input_image, stateful storage или поток. Messages не принимает изображения, tool_use, cache_control или поток. Chat принимает изображения на входе, но только как image_url со ссылкой kvantora-file:<id> на свой готовый файл (внешние https-URL и data-URL отклоняются), и не принимает json_schema, top_p, hosted tools и неизвестные поля. Лимиты изображений в chat: до 9 частей в сообщении, до 32 изображений в запросе, файл до 10 МиБ; модель должна иметь chat_features.image_input. Формат, пример и ошибки: изображения на входе, загрузка файла: приватные файлы.
Медиа выполняются только с опубликованным тарифом. Единица тарифа зависит от модели: запрос, изображение, страница, символы, секунды или токены, а цена может зависеть от настроек (разрешения, длительности). Итог до запуска называет POST /v1/quotes для выбранных параметров; если цену рассчитать нельзя, операция недоступна. Подробно — в оплате.
Генерация изображений, видео и озвучивание требуют доступной операции у выбранной модели. Транскрипции и редактированию изображений нужен собственный проверенный file_id. Транскрипция включена у части моделей каталога, редактирование изображений сейчас не включено ни у одной; если операция у модели выключена, запрос отклоняется до отправки. После отправки с неизвестным исходом не переключайте модель и не создавайте новый запрос автоматически.
Vision, OCR, rerank и music могут встречаться в описаниях моделей. Для запуска через Kvantora ориентируйтесь на доступные операции в availability.operations, а для изображений в chat ещё и на chat_features.image_input, а не только на описание модели.