Інструкція з інтеграції 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": "Біла керамічна чашка з кавою на глянцевій мармуровій стільниці з ранковим світлом з вікна. Камера повільно обертається на 360 градусів навколо чашки, зупиняючись на мить біля ручки."
}'

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

Якщо ви хочете створити відео на основі зображень з початку та кінця, ви можете встановити параметр 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": "Нехай танцює",
    "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 на вказаний 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"
}

Висновок

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

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Проксі

Advanced

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

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

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

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

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

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

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

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

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

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

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

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

Висновок

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

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

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

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

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

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

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

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

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

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

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

​Висновок

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

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

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

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

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

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

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

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

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

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

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

Висновок