Інструкція з інтеграції API генерації відео Veo

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

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

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

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

📘 Повна документація: API генерації відео Veo →

Основне використання

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

Ми можемо бачити, що тут ми налаштували заголовки запиту, включаючи:

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

Також налаштовано тіло запиту, яке включає:

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, злиття кількох зображень для створення відео.
Класифікація режимів:

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

⚠️ Зверніть увагу

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

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

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

{
  "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://platform2.cdn.acedata.cloud/veo/f5389ec0-2eb5-4212-b4a8-04b513b0129a.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，на цей момент статус завдання на створення відео.

Можна побачити, що ми отримали задовільну інформацію про відео, нам лише потрібно за адресою посилання на відео з результату data отримати згенероване відео Veo. Крім того, якщо хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код 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"
    }
  ]
}

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

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

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

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

Натиснувши “Запустити”, можна помітити, що відразу отримано результат, як показано нижче:

{
  "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"
}

Висновок

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

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Проксі

Advanced

Coding

Інструкція з інтеграції API генерації відео Veo

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

Основне використання

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

🔑 Опис ключових правил

⚠️ Зверніть увагу

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

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

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

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

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

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

Висновок

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

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

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

​🔑 Опис ключових правил

​⚠️ Зверніть увагу

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

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

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

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

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

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

​Висновок

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

Основне використання

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

🔑 Опис ключових правил

⚠️ Зверніть увагу

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

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

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

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

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

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

Висновок