Створюйте за допомогою API V4V.
Створюйте зображення, відео та аудіо у власних застосунках. Один API-ключ. Ваші наявні кредити V4V.
https://v4v.ai/api/v1curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Аутентифікація
Створіть іменований ключ у Профілі → API Keys. Збережіть секрет API та секрет підпису вебхука при їх появі; вони показуються лише один раз. Можна створювати та відкликати кілька ключів незалежно. Секрети ключів зберігаються у вигляді хешів SHA-256.
Надсилайте Authorization: Bearer v4v_live_… з кожним запитом API. Зберігайте цей ключ на сервері, поза браузерними додатками та системами контролю версій. Відкликання блокує майбутні запити; вже прийняті генерації продовжуються.
Базова URL-адреса: https://v4v.ai/api/v1.
Пошук моделей Лабораторії
GET /models перелічує поточні ідентифікатори моделей Лабораторії, їхній увімкнений стан, вхідні дані, параметри, значення за замовчуванням, умови та обмеження. GET /models/{model} описує одну модель. Ідентифікатори та схеми походять із того самого каталогу й тих самих значень за замовчуванням, які використовує Лабораторія. Конфігурація Студії окрема.
Назви моделей у наведених нижче прикладах є фактичними ідентифікаторами каталогу. Використовуйте виявлення, щоб знайти моделі, які наразі увімкнені у вашому обліковому записі. Імена полів специфічні для моделі: зберігайте імена, повернені під час виявлення, включно з camelCase, такими як aspectRatio або referenceImageUrls. Значення вибору — рядки; також приймаються числові значення для числових опцій вибору. Поля можна передавати або у вхідних даних, або в параметрах, але не одночасно. Невідомі поля відхиляються. Моделі з вибором версій мають parameters.variant; використовуйте значення та значення за замовчуванням, повернені під час виявлення.
curl https://v4v.ai/api/v1/models \
-H "Authorization: Bearer $V4V_API_KEY"Субтитри з часовими позначками
Знайдіть ai.speech_to_text з типом subtitle. Надішліть ID власного медіафайлу або підтримувану URL-адресу у input.audioUrl або input.videoUrl до POST /lab; необов’язкові параметри включають language_code (наприклад, uk, en або auto) та diarize. Оцінка базується на тривалості оригінального джерела. Транскрипція витрачає звичайні кредити облікового запису.
Завершене завдання повертає results[].type: "subtitle", транскрипт text, srt та редаговані cues з start, end у секундах і text. Успішне тихе введення може мати порожній список позначок. Для монтажу використовуйте інструменти MCP Відеоредактора для вирівнювання цих позначок із обрізкою, швидкістю та позицією на часовій шкалі вихідного кліпу.
Останні моделі генерації
Omni Flash 1.2 (video.gemini_omni_flash-1-2) — рекомендована модель для відеозапитів без явного зазначення моделі. Лабораторія показує її першою; Omni Flash 1.1 залишається доступною в розділі More та за наявним ідентифікатором. Поточні параметри дізнавайтеся через GET /models/{model}. Версія 1.2 підтримує генерацію та редагування тривалістю 3–15 секунд; інтерполяція першого/останнього кадру обмежена 10 секундами. Спільні тарифи на 4/6/8/10 секунд відповідають налаштованим цінам 1.1. Для цін використовуйте поточне виявлення моделі та оцінки, а не зберігайте це співвідношення як постійне правило.
Обирайте GPT Image 2.6 через parameters.variant у image.text_to_image або ai.image_edit. Використовуйте parameters.outputFormat з цими точними можливостями варіантів:
| Варіант | Формати виводу |
|---|---|
gpt-image-2.6-flare-text | png, jpeg, webp, gif, svg |
gpt-image-2.6-sunburst-text | png, jpeg, webp, gif, svg |
gpt-image-2.6-flare-img | png, jpeg, webp |
gpt-image-2.6-sunburst-img | png, jpeg, webp |
gpt-image-2.6-economy-text | png, gif |
gpt-image-2.6-economy-img | png |
parameters_schema.outputFormat.allowed_by_variant є визначальним джерелом. Flare/Sunburst розраховуються за фактичним використанням вводу/виводу; використання конвертації SVG включається до остаточного підсумку. Economy доступний лише для 1K з тарифікацією за зображення. Завантаження зберігають кадри GIF і байти векторного SVG; завантаження SVG використовують доставку як вкладення.
Nano Banana 2.1 використовує parameters.variant: "nano-banana-v2.1" у тих самих модулях зображень, із підтримкою до 10 референсів і виходом 1K/2K/4K. Поточний режим оплати публікується у . Генерація Google/Vertex розраховується за перевіреним вводом, кешованим вводом, вихідним зображенням, текстовим виводом і токенами міркувань, з урахуванням націнки та з одноразовим округленням загального результату вгору. Компонент вихідного зображення приблизно становить 11/16/36 кредитів V4V для 1K/2K/4K до врахування вводу та міркувань. Лабораторія та оцінки показують приблизний діапазон; початкове резервування відокремлене від остаточної вартості. Для інших маршрутів використовується налаштований тариф за зображення. Маршрутизацією й далі керує V4V; не передавайте параметр маршрутизації.
Відеомоделі Kling 4.0
Чотири окремі вузли мають однакові механізми генерації та обробки результатів у Лабораторії, Воркфловах, API та MCP:
| Ідентифікатор каталогу | Модель | Тривалість | Роздільна здатність |
|---|---|---|---|
video.kling_v40_ref | Kling 4.0 Reference | 3–30 секунд | 720p / 1080p |
video.kling_v40_key | Kling 4.0 Keyframe | 3–30 секунд | 720p / 1080p |
video.kling_v40_flash_ref | Kling 4.0 Flash Reference | 3–20 секунд | 720p |
video.kling_v40_flash_key | Kling 4.0 Flash Keyframe | 3–20 секунд | 720p |
Усі приймають обов’язковий prompt (до 8000 символів), цілочисельні duration, resolution та aspectRatio (auto, 16:9, 9:16, 1:1, 21:9; Flash Keyframe виключає auto). Усі можуть генерувати лише з тексту. Вхідні дані Reference є необов’язковими.
Моделі Reference приймають referenceImageUrls (до 10), referenceVideoUrls (до 5), elements (до 7, не більше 3 з відео) та keepOriginalSound. Іменований елемент має name, або imageUrls (2–4 зображення), або videoUrl (один 3–8-секундний кліп персонажа), необов’язкові tag, description (100 символів) та voiceUrl для голосу персонажа. Flash також приймає тип елемента type (image або video). Стандартний Reference додатково приймає voices: до 3 об’єктів з name та audioUrl. Flash натомість прив’язує голоси до елементів персонажів.
Максимум 15 сумарно зображень, референсних відео, елементів та окремих голосів; референсні відео плюс відеоелементи не можуть перевищувати 5. Кожне референсне відео має тривати 2–30 секунд (2–20 секунд для Flash), а їх сумарна тривалість разом із відеоелементами — не більше 30 секунд (20 секунд для Flash). Імена мають бути унікальними без урахування регістру, складатися з 1–20 китайських символів, літер, цифр або підкреслень; вбудовані імена референсів зарезервовані. Згадуйте надані референси як , або їх оголошене . Неоголошені згадки відхиляються.
GPT-6 Astra чат
Отримайте відомості про chat.gpt_6_astra через GET /models/chat.gpt_6_astra (slug: gpt-6-astra). Це тип chat, і він повертає текст. Виявлення моделі включає ставки за токени та правило округлення.
{
"model": "chat.gpt_6_astra",
"input": {
"prompt": "Explain what is in this image.",
"imageUrls": [
"https://example.com/image.png"
]
},
"parameters": {
"reasoningEffort": "high",
"webSearch": true,
"stream": false
}
}Send this body to POST /lab. Images are optional; up to 12 URLs or owned file IDs are accepted. Text-only requests use string input upstream; image requests use an array of message content. Reasoning effort: low, medium, high, xhigh (default low). Web search and streaming default to false. Streamed responses are returned as a completed task after generation finishes.
Щоб запропонувати функцію, передайте input.functionTools як JSON-рядок, що містить 1–10 визначень із type: "function", name, description та parameters (об’єкт JSON Schema). Встановіть parameters.webSearch у false. У зовнішньому запиті використовується tool_choice: "auto"; запити функцій повертаються у results[].function_calls для обробки вашим додатком. Вузол моделі не виконує функції й не продовжує розмову з результатом функції.
Чат резервує 1 кредит перед входом у чергу. Це мінімальне резервування, а не фіксована ціна чи ліміт витрат. Ставки за 1M токенів: вхід 560, кешований вхід 56, запис кешу 700, вивід 2,800 кредитів. Загальна вартість токенів округлюється вгору один раз до цілого кредиту, мінімальна плата — 1. Після відповіді будь-яка додаткова плата списується атомарно з доступного балансу. Якщо балансу недостатньо, завдання завершується з помилкою, а невикористане резервування звільняється.
Для чатів і зображень з оплатою за використання, кінцева точка оцінки також повертає credits_range з min, max, assumptions, includes_markup: true, is_estimate: true та is_spending_cap: false. Відображайте це як приблизний діапазон у кредитах V4V. Він включає поточну націнку та коригування цін. Це ілюстративні сценарії використання; фактична вартість може виходити за межі діапазону. та описують початкове резервування окремо. Діапазон не змінює розрахунок фактичного використання і не дає змоги встановити жорсткий бюджет.
LAB з зовнішнім зображенням
Медіавходи приймають зовнішню URL-адресу або ID файлу V4V у тому самому полі. Масиви можуть містити обидва типи. URL-адреси повинні повертати фактичні медіафайли без браузерних кукі або інтерактивного входу. Рекомендуються HTTPS та підписані URL з достатньою тривалістю дії. V4V перевіряє і копіює зовнішні медіафайли перед генерацією; внутрішні мережеві URL та небезпечні перенаправлення відхиляються.
curl https://v4v.ai/api/v1/lab \
-H "Authorization: Bearer $V4V_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: product-edit-001' \
-d '{"model":"ai.image_edit","input":{"prompt":"Place this product on a marble counter","referenceImageUrls":["https://example.com/product.jpg"]},"parameters":{"variant":"nano-banana-2","aspectRatio":"9:16","resolution":"2K"}}'Завантаження приватних медіафайлів
POST /files приймає поле file у форматі multipart/form-data. Підтримуються зображення, відео та аудіо, з урахуванням обмежень моделей. За замовчуванням ліміт завантаження — 100 MiB, додатково обмежений лімітом завантаження сховища в розгортанні та лімітом проксі. Файли мають містити медіадані, які можна декодувати; для перевірки аудіо/відео на сервері потрібен ffprobe.
curl https://v4v.ai/api/v1/files \
-H "Authorization: Bearer $V4V_API_KEY" \
-F 'file=@product.png'{
"id": "6aa962444bd1dd7ab65bc6b6",
"type": "image",
"content_type": "image/png",
"size": 123456
}Використовуйте повернений ID напряму, без префікса file_. GET /files/{id} повертає метадані вашого файлу без списання кредитів.
{
"model": "ai.image_edit",
"input": {
"prompt": "Create a studio product photograph",
"referenceImageUrls": [
"6aa962444bd1dd7ab65bc6b6",
"https://example.com/side.jpg"
]
},
"parameters": {
"variant": "nano-banana-2"
}
}Студія з зовнішніми або приватними медіафайлами
POST /studio використовує той самий вибраний воркфлов Студії, підготовку, виконання моделі, множник ціни та знижку підписки, що й інтерфейс Студії.
{
"input": {
"product_name": "Example Product",
"product_description": "Lightweight everyday backpack",
"product_images": [
"https://example.com/front.jpg",
"6aa962444bd1dd7ab65bc6b6"
],
"prompt": "Show the product in everyday use"
},
"parameters": {
"duration": 10,
"aspect_ratio": "9:16",
"style": "UGC",
"language": "en",
"avatar": null
},
"callback_url": "https://partner.example/webhooks/v4v"
}Для повністю приватного процесу з медіафайлами спочатку завантажте кожне зображення продукту через POST /files, потім вставте повернені ID у input.product_images. Так само завантажуйте аватар, аудіо та відеореференси.
Студія приймає product_id (власний збережений продукт), avatar_id (власний або активний публічний аватар медіатеки, підтримується префікс public:), product_name, product_description, prompt, product_images, reference_images, avatar_media, audio та video. Кожне медіаполе приймає референси; масиви підтримують кілька файлів. parameters.avatar приймає ID аватара медіатеки, одну URL-адресу зображення або ID файлу, або null. Обирайте або input.avatar_id, або parameters.avatar. Явно задані поля продукту мають пріоритет над налаштуваннями медіатеки. Активні імена/ID стилів застосовують збережені інструкції стилю. Невідомі, неактивні та порожні значення стилю повертають 422 INVALID_PARAMETER, field: "parameters.style" та error.allowed_values, що містить активні ID/імена. Пропустіть стиль, щоб використати поточний стиль за замовчуванням (UGC, якщо активний, інакше перший активний пресет). Параметри також включають style, language, voice, placement, duration, aspect_ratio та quality.
Міграція для клієнтів, які раніше передавали вільний текст у parameters.style: перенесіть цей творчий напрямок у input.prompt і оберіть активний стиль із MCP (або пропустіть стиль для поточного за замовчуванням). Неправильно написаний стиль більше не стає користувацьким стилем.
Завдання та кредити
Генерація повертає HTTP 202 після перевірки вводу та, коли є доступна потужність, резервування кредитів, не чекаючи генерації:
{
"task_id": "task_6aa962444bd1dd7ab65bc6b6",
"status": "queued",
"credits_reserved": 20,
"created_at": "2026-09-15T18:00:00Z"
}Необов’язкова назва проєкту
Обидва POST /lab і POST /studio приймають project_name на верхньому рівні, поруч з input, parameters та callback_url:
{
"project_name": "Summer campaign — product photo",
"model": "image-upscale-topaz",
"input": {
"image_url": "https://example.com/product.png"
},
"parameters": {
"upscale_factor": "2"
}
}Назва після обрізання (1–200 символів, не порожня) стає заголовком у Проєктах і, для LAB, в Old runs. Якщо її не вказано, використовується наявний заголовок за замовчуванням. Відповідь завдання містить project_name та project_id. Зміна назви з тим самим ключем ідемпотентності спричиняє конфлікт, так само як і зміна вхідних даних генерації.
Статус завдання
Сервер оновлює статус генерації у фоновому режимі. Опитування повертає останній збережений status: queued, processing, completed, failed або cancelled. Поки завдання має статус queued або processing, показуйте індикатор завантаження. Коли status — completed, читайте текст чату з results[].text або завантажуйте медіафайли з results. Для failed перевірте error (включно з неуспішним stage, brief_completed, retryable та рекомендованим retry_after_seconds, якщо відомо) і credits_used. Успішне створення короткого опису може зберігати пов’язане з ним списання, якщо рендеринг не вдався; тимчасова підказка повторної спроби не запускає і не дозволяє нову платну спробу. cancelled також є кінцевим статусом.
Вебхуки є необов’язковими. Без callback_url повторюйте наступний запит кожні 3–5 секунд, доки status не стане completed, failed або cancelled:
curl "$V4V_BASE_URL/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $V4V_API_KEY"Перейменування та організація проєктів
Організація проєктів використовує ті ж папки, що й робочий простір Проєкти. Вона не генерує медіа, не резервує кредити і не змінює вхідні дані генерації, результати або хеші ідемпотентності. Всі операції вимагають вашого API-ключа і мають доступ лише до проєктів і папок вашого акаунту.
| Метод і шлях | Призначення |
|---|---|
GET /projects | Знайти проєкти Студії, воркфловів і LAB, включно із завданнями API в черзі |
PATCH /projects/{project_id} | Перейменувати проєкт і/або перемістити його до папки |
GET /project-folders | Перелік папок робочого простору |
POST /project-folders | Створити папку з {"name":"Summer campaign"} |
PATCH /project-folders/{folder_id} | Перейменувати папку з {"name":"Autumn campaign"} |
Обидві кінцеві точки списку приймають offset (за замовчуванням 0) і limit (1–100, за замовчуванням 50), повертаючи total і next_offset (null на останній сторінці). Проєкти сортуються від найновіших до найстаріших зі стабільним розв’язанням однакових значень за ID; папки сортуються за назвою. Фільтри проєктів: source=all|studio|workflow|lab, q (буквальний пошук за назвою без урахування регістру, до 200 символів) і folder_id (ID папки, що належить вам, або unfiled для проєктів без папки). Пропустіть folder_id, щоб включити всі папки.
GET /projects повертає projects з полями project_id, project_name, source, folder_id (рядок або null), status, created_at і updated_at. Статус відображає оригінальну історію проєкту або LAB; для статусу генерації використовуйте GET /tasks/{task_id}. Використовуйте повернутий project_id для оновлень; спадкові записи LAB без проєкту використовують свій ID запуску LAB. повертає з полями , , , і .
Ідемпотентність
Надсилайте Idempotency-Key (1–200 символів) під час надсилання запитів LAB або Студії. Той самий акаунт, значення ключа, ендпоінт і JSON-вміст повертають оригінальне завдання, зокрема й через різні API-ключі цього акаунта. Порядок властивостей об’єкта ігнорується. Повторне використання ключа з іншим вмістом повертає HTTP 409 IDEMPOTENCY_CONFLICT. Якщо оригінальний запит ще перевіряється, HTTP 409 REQUEST_IN_PROGRESS просить повторити запит із тим самим ключем. Відхилене надсилання залишається пов’язаним із ключем; виправте його, використовуючи новий ключ.
Постійні унікальні індекси не дають одночасним повторним спробам створити іншу генерацію або резервування. Записи ідемпотентності зберігаються разом з історією завдань.
Підписані зворотні виклики
Надайте необов’язковий публічний callback_url. V4V надсилає task.completed або task.failed з полями завдання, списком результатів і стабільним event_id. Зворотні виклики мають заголовки X-V4V-Timestamp і X-V4V-Signature: v1=<hex>. Перевіряйте за допомогою секрету підпису вебхука, показаного при створенні API-ключа.
Підпис — це HMAC-SHA256 для часової позначки, літеральної крапки й точного необробленого тіла запиту. Відхиляйте застарілі часові позначки (наприклад, старші за п’ять хвилин) і порівнюйте підписи в сталий час.
import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', webhookSecret)
.update(`${timestamp}.${rawBody}`).digest('hex');
const valid = /^v1=[a-f0-9]{64}$/.test(signature)
&& Math.abs(Date.now() / 1000 - Number(timestamp)) < 300
&& crypto.timingSafeEqual(Buffer.from(signature.slice(3), 'hex'), Buffer.from(expected, 'hex'));Швидко повертайте відповідь 2xx. Доставка відбувається принаймні один раз: уникайте дублювання за event_id. Збої мережі, тайм-аути, HTTP 408/429 і відповіді 5xx повторюються з експоненційним збільшенням інтервалу, починаючи з 30 секунд і максимум до однієї години, до 12 спроб за замовчуванням. Інші неуспішні відповіді, включно з перенаправленнями, припиняють доставку. Повторні спроби ніколи не створюють генерацій і не списують кредити. Опитуйте статус завдання, якщо доставка зворотного виклику вичерпана.
Зворотні виклики пакетів Студії
POST /studio/batches також приймає необов’язковий callback_url. Застосовується та сама перевірка підписаного зворотного виклику. Події: batch.updated, batch.completed, batch.paused і batch.cancelled зі стабільними event_id, batch_id, batch_revision, observed_at, state_token, лічильниками та сумами кредитів. Для перегляду поточних пагінованих результатів використовуйте GET /studio/batches/{batch_id}. Події містять компактні знімки замість URL завантаження, що спливають; проміжні зміни можуть об’єднуватися між циклами виконавця.
Доставка є надійною і повторюється незалежно від генерації. Уникайте дублювання за event_id і толеруйте події поза порядком; повторна доставка зберігає те саме тіло. Повільні або несправні приймачі не створюють нових генерацій і не блокують чергу генерації. Скасування може викликати подальше оновлення, коли вже прийнята робота завершується. Пізніший запит на перезапуск або доопрацювання реактивує моніторинг. Вебхук — це HTTP-інтеграція і сам по собі не активує завершений чат у браузері.
Помилки та обмеження
Помилки мають єдину структуру:
{
"error": {
"code": "INVALID_PARAMETER",
"message": "Allowed values: 5, 10.",
"field": "parameters.duration"
}
}HTTP 400/422 означає недійсні вхідні дані або параметри; 401 — недійсний/скасований ключ; 402 — недостатньо кредитів; 403 — вимкнені моделі або відмовлений доступ; 404 — недоступні моделі/файли/завдання; 409 — конфлікт ідемпотентності або триває перевірка; 429 — обмеження швидкості/конкурентності; 500 — внутрішня помилка; 503 — тимчасова недоступність сервісу. Коди помилок включають INVALID_API_KEY, INSUFFICIENT_CREDITS, MODEL_NOT_FOUND, MODEL_DISABLED, INVALID_INPUT, INVALID_PARAMETER, INVALID_MEDIA_URL, MEDIA_NOT_ACCESSIBLE, UNSUPPORTED_MEDIA_TYPE, MEDIA_TOO_LARGE, FILE_NOT_FOUND, FILE_ACCESS_DENIED, RATE_LIMIT_EXCEEDED, GENERATION_FAILED, GENERATION_SERVICE_ERROR і SERVICE_UNAVAILABLE. GENERATION_SERVICE_ERROR позначає зареєстровану внутрішню помилку сервісу моделі; це не означає, що розмір вхідних даних або параметри були недійсними. Відсутні та недоступні ID файлів мають спільну відповідь 404, щоб уникнути розкриття файлів інших акаунтів.
Default limits are 120 requests per minute per key, 10 generation submissions per minute per account, and 3 concurrent accepted generations per account. Every HTTP 429 includes error.retryable and a positive integer error.retry_after_seconds; the HTTP Retry-After header uses the same value. Request-window errors also return reason: "request_rate_limit", the configured limit, and a public scope (key, generation, bulk, mcp-upload-link or mcp-upload), without internal account/key IDs. The retry delay is the rounded-up time remaining in the minute window, not always 60 seconds. MCP tool errors preserve these fields in their JSON even when HTTP headers are unavailable. Account contention uses its own reason: "account_busy" and one-second delay. Generation capacity is handled separately by the durable queue; wait for the accepted task rather than resubmitting it.
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "API rate limit exceeded. Retry after 18 seconds.",
"reason": "request_rate_limit",
"scope": "key",
"limit": 120,
"retryable": true,
"retry_after_seconds": 18
}
}Для відмов у вікні запиту (до створення завдання) зачекайте вказану затримку і повторно використайте той самий ключ ідемпотентності та аргументи. Відповідь, що ідентифікує вже неуспішне завдання, є кінцевою для цього завдання. Це не дозволяє ще одну платну спробу після кінцевої відмови генерації.
Масова генерація Студії (API і MCP)
Масова генерація доступна через API і MCP. В інтерфейсі Студії поки що немає окремого робочого простору для масової генерації. Надсилайте до 300 продуктів в одному JSON-запиті. Кожен елемент створює один воркфлов Студії з власним завданням, збереженим воркфловом/налаштуваннями, результатами та обліком кредитів. Імпорт продуктів і завантаження референсів відбуваються у фоновому режимі; недійсний елемент завершується помилкою окремо, а решта елементів продовжує обробку.
Студія, LAB, REST, MCP, Shopify та генерація аватарів використовують спільну постійну чергу сервера з абсолютним лімітом у 10 активних запитів на генерацію для цього розгортання. Очікування результату генерації займає слот. Завершена генерація звільняє цей слот навіть під час збереження файлу. Звичайні запити мають пріоритет над масовими; масові використовують доступну потужність з урахуванням глобальних обмежень адміністратора на масові запити та обмежень на акаунт. За замовчуванням дозволено 2 одночасні масові воркфлови та 1 на акаунт. Кілька пакетів одного акаунта ділять це обмеження. Обробка продовжується без відкритого браузера або опитування клієнтом.
Створити пакет
POST /api/v1/studio/batches — повертає HTTP 202. Обов’язково вкажіть заголовок Idempotency-Key довжиною від 1 до 200 символів. Повторно використовуйте той самий ключ і ідентичний JSON після переривання мережі. Змінене тіло з тим самим ключем повертає HTTP 409; прийняття ніколи не створює другий пакет для повторної спроби.
curl "$V4V_BASE_URL/api/v1/studio/batches" \
-H "Authorization: Bearer $V4V_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: autumn-catalogue-001' \
--data '{
"name": "Autumn catalogue",
"max_credits": 600,
"input": { "prompt": "Show three benefits of this product in a calm reveal" },
"parameters": { "duration": 8, "aspect_ratio": "9:16", "quality": "720p" },
"items": [
{ "sku": "MUG-01", "product_id": "0123456789abcdef01234567" },
{ "sku": "BAG-02", "product_url": "https://shop.example/products/bag?variant=blue" },
{
"sku": "LAMP-03",
"input": {
"product_name": "Desk lamp",
"product_description": "Adjustable warm light",
"product_images": ["https://shop.example/lamp.jpg"]
},
"parameters": { "style": "TV Spot" }
}
]
}'Використовуйте тривалість, формат і якість, підтримувані поточним воркфловом Студії вашого розгортання, як для POST /api/v1/studio. У прикладі бюджет становить 600 кредитів для трьох 8-секундних кліпів Omni 720p: 3 × 180 = 540 кредитів, залишаючи 60 кредитів запасу. Три 10-секундні кліпи у 720p використовують 675 кредитів; у 1080p — 990, а у 4K — 1 980, без урахування тарифікації за референсне відео, додаткових кроків або повторних спроб. Завжди отримуйте актуальні оцінки для точних вхідних даних перед вибором бюджету пакета.