Інструкція з інтеграції Veo Videos Generation API

У цій статті буде представлено інструкцію з інтеграції Veo Videos Generation API, за допомогою якого можна генерувати офіційні відео Veo, вводячи власні параметри.

Процес подання заявки

Щоб використовувати Veo Videos Generation API, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token і зберегти його для подальшого використання.

Якщо ви ще не увійшли або не зареєструвалися, вас буде автоматично перенаправлено на сторінку входу із запрошенням зареєструватися та увійти, після завершення ви автоматично повернетеся на поточну сторінку. Один API Token може викликати всі сервіси платформи, немає потреби подавати заявку окремо для кожного сервісу. Під час першого подання заявки буде надано безкоштовний ліміт для безкоштовного ознайомлення; якщо ліміту недостатньо, ви можете поповнити універсальний баланс у консолі.

📘 Повна документація: Veo Videos Generation API →

Базове використання

Спочатку розглянемо базовий спосіб використання: введіть промпт prompt, дію генерації action, масив зображень для посилань на перший і останній кадри image_urls, а також модель model, і ви отримаєте оброблений результат. Спочатку потрібно просто передати поле action зі значенням text2video, воно переважно містить три дії: генерація відео з тексту (text2video), генерація відео із зображення (image2video), отримання відео 1080p (get1080p), далі також потрібно ввести модель model; наразі доступні моделі veo31-fast, veo3, veo31, veo3-fast і veo31-fast-ingredients, конкретний вміст наведено нижче:

Тут можна побачити, що ми налаштували Request Headers, зокрема:

accept: у якому форматі бажано отримати результат відповіді; тут вказано application/json, тобто формат JSON.
authorization: ключ для виклику API, після отримання заявки його можна безпосередньо вибрати зі спадного списку.

Також налаштовано Request Body, зокрема:

model: модель для генерації відео; основними є моделі veo31-fast, veo3, veo31, veo3-fast і veo31-fast-ingredients.
action: дія цього завдання з генерації відео; переважно містить три дії: генерація відео з тексту (text2video), генерація відео із зображення (image2video), отримання відео 1080p (get1080p).
image_urls: посилання на зображення для завантаження, яке обов’язково потрібне при виборі дії генерації відео із зображення image2video. Для veo31-fast-ingredients — максимум 3 зображення (об’єднання кількох зображень), для інших моделей — максимум 2 зображення (режим першого й останнього кадрів).
resolution: вибір роздільної здатності генерованого відео; серед них модель veo31 підтримує роздільну здатність 4k, інші моделі її не підтримують, усі моделі підтримують роздільні здатності 1080p і gif; якщо це значення не передано, за замовчуванням використовується роздільна здатність 720p; основні варіанти: 1080p, gif, 4k.
prompt: промпт.
callback_url: URL, на який потрібно отримати результат зворотного виклику.
async: необов’язково; коли встановлено значення true, інтерфейс негайно повертає task_id, без необхідності надавати callback_url, після чого результат отримується шляхом опитування через відповідний інтерфейс запиту завдання.

📌 Підсумок опису моделей

Назва моделі	Підтримувані режими	Правила введення зображень
veo3-fast	Генерація відео з тексту (без зображень) Режим генерації відео із зображення (із зображеннями)	1 зображення → режим першого кадру 2 зображення → режим першого й останнього кадрів
veo31-fast	Генерація відео з тексту (без зображень) Режим генерації відео із зображення (із зображеннями)	1 зображення → режим першого кадру 2 зображення → режим першого й останнього кадрів
veo31-fast-ingredients	❌ Генерація відео з тексту (не підтримується) ✅ Примусове об’єднання кількох зображень (необхідно передати зображення)	1-3 зображення → режим об’єднання кількох зображень (максимум 3 зображення)
veo3	Генерація відео з тексту (без зображень) Режим генерації відео із зображення (із зображеннями)	1 зображення → режим першого кадру 2 зображення → режим першого й останнього кадрів
veo31	Генерація відео з тексту (без зображень) Режим генерації відео із зображення (із зображеннями)	1 зображення → режим першого кадру 2 зображення → режим першого й останнього кадрів

🔑 Пояснення ключових правил

Загальна логіка:
- Без введення зображень → автоматично активується режим генерації відео з тексту.
- З введенням зображень → активується режим генерації відео із зображення (конкретна поведінка визначається кількістю зображень).
Типи режиму генерації відео із зображення:
- Режим першого кадру (1 зображення): перший кадр фіксується як введене зображення.
- Режим першого й останнього кадрів (2 зображення): перший і останній кадри фіксуються як введені зображення.
- Режим об’єднання кількох зображень (1-3 зображення): підтримується лише veo31-fast-ingredients, генерує відео шляхом об’єднання вмісту кількох зображень.
Класифікація режимів:

Режим Fast: veo3-fast, veo31-fast, veo31-fast-ingredients.
Режим Quality: veo3, veo31 (вища якість генерації).

⚠️ Примітки

Єдина модель з обов’язковим передаванням зображень: для veo31-fast-ingredients необхідно передати зображення (1-3), інакше вона не зможе працювати.
Обмеження кількості зображень:
- veo31-fast-ingredients підтримує введення 1-3 зображень (режим об’єднання кількох зображень).
- Інші моделі підтримують максимум 2 зображення (режим першого й останнього кадрів).

Після вибору можна побачити, що праворуч також згенеровано відповідний код, як показано на зображенні:

Натисніть кнопку «Try», щоб провести тестування; як показано на зображенні вище, тут ми отримали такий результат:

{
  "success": true,
  "task_id": "697ea2fc-58fd-48c8-8191-29041ff23c3c",
  "trace_id": "70e1cb12-c619-4292-a416-90191205996b",
  "data": [
    {
      "id": "24ac06a5-9cc7-448f-802e-0b4db19f6e96",
      "video_url": "https://cdn.acedata.cloud/assets/examples/veo/f5389ec0-2eb5-4212-b4a8-04b513b0129a-0b0c3113d691.mp4",
      "created_at": "2026-06-30T04:01:50.364Z",
      "complete_at": "2026-06-30T04:03:20.495Z",
      "state": "succeeded"
    }
  ]
}

Результат відповіді містить кілька полів, опис яких наведено нижче:

success，станус завдання генерації відео в цей момент。
task_id，ID завдання генерації відео в цей момент。
data，результат завдання генерації відео в цей момент。
- id，ID відео завдання генерації відео в цей момент。
- video_url，посилання на відео завдання генерації відео в цей момент。
- created_at，час створення завдання генерації відео в цей момент。
- complete_at，час завершення завдання генерації відео в цей момент。
- state，стан завдання генерації відео в цей момент。

Можна побачити, що ми отримали задовільну інформацію про відео, нам потрібно лише отримати згенероване відео Veo за адресою посилання на відео в data результату。 Крім того, якщо ви хочете згенерувати відповідний код інтеграції, можете безпосередньо скопіювати згенерований, наприклад, код CURL наведено нижче：

curl -X POST 'https://api.acedata.cloud/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo31-fast",
  "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle."
}'

Функція генерації відео із зображень

Якщо ви хочете генерувати відео на основі зображень першого та останнього кадрів, можна встановити параметр action як image2video і ввести масив посилань на зображення першого та останнього кадрів image_urls。 Далі нам потрібно обов’язково заповнити підказки, які необхідно розширити на наступному кроці, щоб налаштувати генерацію відео, можна вказати такий вміст：

model：модель для генерації відео, основні: veo31-fast、veo3、veo31、veo3-fast і veo31-fast-ingredients。
image_urls：коли вибрано дію генерації відео із зображень image2video, обов’язково потрібні посилання на завантажені еталонні зображення。
prompt：підказка。

Приклад заповнення наведено нижче：

Після завершення заповнення автоматично генерується такий код：

Відповідний код Python：

import requests

url = "https://api.acedata.cloud/veo/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "image2video",
    "model": "veo31-fast",
    "prompt": "Let it dance",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Натисніть запуск, і можна побачити, що буде отримано результат, як показано нижче：

{
  "success": true,
  "task_id": "98e309f3-35bc-438d-8cb3-4015fc864b87",
  "trace_id": "8bc68066-36de-41ef-ae5e-b7d61ff6aee8",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/98e309f3-35bc-438d-8cb3-4015fc864b87.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

Можна побачити, що вміст результату узгоджується з наведеним вище, таким чином реалізується функція генерації відео із зображень。

Функція отримання відео 1080p

Якщо ви хочете отримати 1080p для вже згенерованого відео Veo, можна встановити параметр action як get1080p і ввести ID відео, для якого потрібно отримати 1080p; ID відео отримується відповідно до базового використання, як показано на зображенні нижче：

У цей момент можна побачити, що ID відео становить：

"id": "59f12222b1fa4fbe9331ff2400ad1583"

Зверніть увагу, video_id у цьому відео — це ID відео після генерації; якщо ви не знаєте, як генерувати відео, можете звернутися до базового використання вище для генерації відео。

Далі нам потрібно обов’язково заповнити підказки, які необхідно розширити на наступному кроці, щоб налаштувати генерацію відео, можна вказати такий вміст：

model：модель для генерації відео, основні: veo31-fast、veo3、veo31、veo3-fast і veo31-fast-ingredients。
video_id：ID еталонного відео, використовується для отримання відео 1080p。

Приклад заповнення наведено нижче：

Після завершення заповнення автоматично генерується такий код：

Натисніть запуск, і можна побачити, що буде отримано результат, як показано нижче：

{
  "success": true,
  "task_id": "47a51cfe-2e24-4aba-93b3-546c2dc52984",
  "trace_id": "a8922eec-6f50-4f77-8104-00ded071d59d",
  "data": [
    {
      "id": "59f12222b1fa4fbe9331ff2400ad1583",
      "video_url": "https://platform.cdn.acedata.cloud/veo/47a51cfe-2e24-4aba-93b3-546c2dc52984.mp4",
      "created_at": "2025-07-25 16:13:07",
      "complete_at": "2025-07-25 16:16:12",
      "state": "succeeded"
    }
  ]
}

Можна побачити, що вміст результату узгоджується з наведеним вище, таким чином реалізується функція отримання відео 1080p。

Генерація із вказаним розміром відео

Якщо ви хочете вказати генерацію відео Veo нестандартного розміру, можна встановити параметр aspect_ratio як бажаний розмір, далі нам потрібно обов’язково заповнити підказки, які необхідно розширити на наступному кроці, щоб налаштувати генерацію відео, можна вказати такий вміст：

model：модель для генерації відео, основні: veo31-fast、veo3、veo31、veo3-fast і veo31-fast-ingredients。
aspect_ratio：розмір відео, наразі підтримуються: 16:9、16:9、3:4、4:3、1:1, за замовчуванням 16:9。
translation：чи ввімкнути автоматичний переклад підказок, за замовчуванням false。 Приклад заповнення наведено нижче：

Після завершення заповнення автоматично генерується такий код：

Натисніть запуск, і можна побачити, що буде отримано результат, як показано нижче：

{
  "success": true,
  "task_id": "d2b93290-ab0e-4d20-ae45-60c062a32687",
  "trace_id": "9834e64d-c8fe-43ae-8114-ee2b5f93d886",
  "data": [
    {
      "id": "fc667e7d3b8f44beaa61a3c339af0e50",
      "video_url": "https://platform.cdn.acedata.cloud/veo/d2b93290-ab0e-4d20-ae45-60c062a32687.mp4",
      "created_at": "2025-08-24 20:09:06",
      "complete_at": "2025-08-24 20:10:45",
      "state": "succeeded"
    }
  ]
}

Як видно, вміст результату узгоджується з наведеним вище, що реалізує функцію генерування відео заданого розміру.

Асинхронний зворотний виклик

Оскільки час генерування Veo Videos Generation API є відносно тривалим, приблизно 1–2 хвилини, якщо API тривалий час не відповідає, HTTP-запит постійно підтримуватиме з’єднання, що призводить до додаткового споживання системних ресурсів, тому цей API також підтримує асинхронні зворотні виклики. Загальний процес такий: коли клієнт ініціює запит, він додатково вказує поле callback_url; після того як клієнт надсилає API-запит, API негайно повертає результат, що містить поле task_id, яке представляє ID поточного завдання. Після завершення завдання результат генерування відео буде надіслано у форматі POST JSON до callback_url, вказаного клієнтом, де також міститиметься поле task_id, таким чином результати завдання можна пов’язати за ID. Нижче ми на прикладі розглянемо, як саме це зробити. Спочатку, зворотний виклик Webhook — це сервіс, який може приймати HTTP-запити, і розробник має замінити його на URL власного HTTP-сервера. Для зручності демонстрації тут використовується публічний зразковий сайт Webhook https://webhook.site/; відкривши цей сайт, можна отримати Webhook URL, як показано на зображенні:

Скопіюйте цей URL, і його можна буде використовувати як Webhook; приклад тут: https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc. Далі ми можемо встановити для поля callback_url вказаний вище Webhook URL і водночас заповнити відповідні параметри; конкретний вміст показано на зображенні:

Натисніть «Запустити», і можна побачити, що результат буде отримано негайно, як показано нижче:

{
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"
}

Зачекавши деякий час, ми можемо спостерігати результат генерування відео на https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc, як показано на зображенні:

Вміст такий:

{
  "success": true,
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed",
  "trace_id": "d1d53c04-58c5-4c40-bb63-f00188540e56",
  "data": [
    {
      "id": "2f43ceed37944b4d836e1a1899dad0a1",
      "video_url": "https://platform.cdn.acedata.cloud/veo/1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed.mp4",
      "created_at": "2025-07-25 17:19:20",
      "complete_at": "2025-07-25 17:21:45",
      "state": "succeeded"
    }
  ]
}

Можна побачити, що в результаті є поле task_id, а інші поля аналогічні наведеним вище; за допомогою цього поля можна реалізувати пов’язування завдань.

Обробка помилок

Під час виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:

400 token_mismatched：Неправильний запит, можливо через відсутні або недійсні параметри.
400 api_not_implemented：Неправильний запит, можливо через відсутні або недійсні параметри.
401 invalid_token：Неавторизовано, недійсний або відсутній токен авторизації.
429 too_many_requests：Занадто багато запитів, ви перевищили ліміт частоти.
500 api_error：Внутрішня помилка сервера, на сервері щось пішло не так.

Приклад відповіді з помилкою

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

За допомогою цього документа ви вже дізналися, як використовувати Veo Videos Generation API для генерування відео шляхом введення текстової підказки та еталонного зображення першого кадру. Сподіваємося, цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас виникнуть будь-які запитання, будь ласка, звертайтеся до нашої команди технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Coding

Інші посібники

Інструкція з інтеграції Veo Videos Generation API

Процес подання заявки

Базове використання

📌 Підсумок опису моделей

🔑 Пояснення ключових правил

⚠️ Примітки

Функція генерації відео із зображень

Функція отримання відео 1080p

Генерація із вказаним розміром відео

Асинхронний зворотний виклик

Обробка помилок

Приклад відповіді з помилкою

Висновок

​Процес подання заявки

​Базове використання

​📌 Підсумок опису моделей

​🔑 Пояснення ключових правил

​⚠️ Примітки

​Функція генерації відео із зображень

​Функція отримання відео 1080p

​Генерація із вказаним розміром відео

​Асинхронний зворотний виклик

​Обробка помилок

​Приклад відповіді з помилкою

​Висновок

Процес подання заявки

Базове використання

📌 Підсумок опису моделей

🔑 Пояснення ключових правил

⚠️ Примітки

Функція генерації відео із зображень

Функція отримання відео 1080p

Генерація із вказаним розміром відео

Асинхронний зворотний виклик

Обробка помилок

Приклад відповіді з помилкою

Висновок