Создать задание: video_generation

POST/v1/videos

Требуемое право: video. Асинхронный JSON-контракт Kvantora; не полная совместимость с OpenAI media API. Один результат. Только опубликованный фиксированный тариф за запрос. Файлы входа принадлежат владельцу ключа и прошли проверку. MEDIA_ENABLED по умолчанию выключен.

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Заголовки

Idempotency-Keystringобязательныйдлина 1–200

Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

Тело запроса

application/json · обязательное

modelstringобязательныйдлина 1–200

promptstringобязательныйдлина 1–32000

max_cost_microrubinteger0 … 9007199254740991

Ответы

200Повтор уже завершённого задания

application/json

idstringобязательныйuuid

object"generation.job"обязательный

modelstringобязательный

operationstringобязательный

Значения: "image_generation" "image_editing" "video_generation" "text_to_speech" "speech_to_text"

statusstringобязательный

Значения: "queued" "running" "storing" "succeeded" "cancelled" "failed" "unknown"

mockbooleanобязательный

created_atstringобязательныйdate-time

updated_atstringобязательныйdate-time

outputobject | nullобязательный

Вложенные поля

Один из вариантов

Вариант 1

file_idstringобязательныйuuid

errorobject | nullобязательный

Вложенные поля

Один из вариантов

Вариант 1

codestringобязательный

billingobjectобязательный

Вложенные поля

statusstring

estimated_cost_microrubinteger0 … 9007199254740991

cost_microrubinteger | null

202Задание принято

application/json

idstringобязательныйuuid

object"generation.job"обязательный

modelstringобязательный

operationstringобязательный

Значения: "image_generation" "image_editing" "video_generation" "text_to_speech" "speech_to_text"

statusstringобязательный

Значения: "queued" "running" "storing" "succeeded" "cancelled" "failed" "unknown"

mockbooleanобязательный

created_atstringобязательныйdate-time

updated_atstringобязательныйdate-time

outputobject | nullобязательный

Вложенные поля

Один из вариантов

Вариант 1

file_idstringобязательныйuuid

errorobject | nullобязательный

Вложенные поля

Один из вариантов

Вариант 1

codestringобязательный

billingobjectобязательный

Вложенные поля

statusstring

estimated_cost_microrubinteger0 … 9007199254740991

cost_microrubinteger | null

ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный

Вложенные поля

codestringобязательный

messagestringобязательный

request_idstring

typestring

curl --request POST \ --url "https://api.kvantora.ai/v1/videos" \ --header "Authorization: Bearer $KVANTORA_API_KEY" \ --header "Idempotency-Key: $REQUEST_ID" \ --header "Content-Type: application/json" \ --data '{ "model": "<public_api_id>", "prompt": "Кот в космосе, акварель" }'

import os import requests response = requests.post( "https://api.kvantora.ai/v1/videos", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", "Idempotency-Key": os.environ["REQUEST_ID"], }, json={ "model": "<public_api_id>", "prompt": "Кот в космосе, акварель", }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/videos', { method: 'POST', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'Idempotency-Key': process.env.REQUEST_ID, 'Content-Type': 'application/json', }, body: JSON.stringify({ "model": "<public_api_id>", "prompt": "Кот в космосе, акварель" }), }); console.log(await response.json());

{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "object": "generation.job", "model": "<public_api_id>", "operation": "image_generation", "status": "queued", "mock": true, "created_at": "2026-09-28T12:00:00Z", "updated_at": "2026-09-28T12:00:00Z", "output": { "file_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "error": { "code": "<string>" }, "billing": { "status": "<string>", "estimated_cost_microrub": 0, "cost_microrub": 0 } }