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, конкретное содержание представлено ниже:

Как видно, мы настроили заголовки запроса, включая:

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

Fast режим: veo3-fast, veo31-fast, veo31-fast-ingredients.
Quality режим: 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，в данный момент состояние задачи по генерации видео.

Можно увидеть, что мы получили удовлетворительную информацию о видео, нам нужно только получить сгенерированное видео 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": "Белая керамическая кружка с кофе на блестящем мраморном столешнице при утреннем свете из окна. Камера медленно вращается на 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, представляющем текущий идентификатор задачи. Когда задача завершена, результат генерации видео будет отправлен на указанный клиентом 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 Videos Generation для генерации видео с помощью вводимых подсказок и изображения первого кадра. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Veo Videos Generation API интеграция

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

Основное использование

📌 Резюме описания моделей

🔑 Объяснение ключевых правил

⚠️ Важные замечания

Функция генерации видео из изображений

Функция получения видео в 1080p

Генерация видео с заданными размерами

Асинхронный обратный вызов

Обработка ошибок

Пример ответа об ошибке

Заключение

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

​Основное использование

​📌 Резюме описания моделей

​🔑 Объяснение ключевых правил

​⚠️ Важные замечания

​Функция генерации видео из изображений

​Функция получения видео в 1080p

​Генерация видео с заданными размерами

​Асинхронный обратный вызов

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

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

Основное использование

📌 Резюме описания моделей

🔑 Объяснение ключевых правил

⚠️ Важные замечания

Функция генерации видео из изображений

Функция получения видео в 1080p

Генерация видео с заданными размерами

Асинхронный обратный вызов

Обработка ошибок

Пример ответа об ошибке

Заключение