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

В данной статье будет представлено руководство по интеграции Veo Videos Generation API, который позволяет генерировать официальные видео Veo с помощью ввода пользовательских параметров.

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

Чтобы использовать API, сначала необходимо перейти на страницу Veo Videos Generation API и подать заявку на соответствующую услугу. После перехода на страницу нажмите кнопку «Acquire», как показано на изображении:

Если вы еще не вошли в систему или не зарегистрированы, вас автоматически перенаправит на страницу входа, где вам будет предложено зарегистрироваться и войти. После регистрации и входа вы автоматически вернетесь на текущую страницу. При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать данный API.

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

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

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

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

Также установлен тело запроса, включая:

model: модель для генерации видео, в основном veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients и veo3-fast.
action: действие для данной задачи генерации видео, которое включает три основных действия: создание видео из текста (text2video), создание видео из изображения (image2video), получение видео в 1080p (get1080p).
image_urls: ссылки на изображения, которые необходимо загрузить при выборе действия создания видео из изображения image2video, максимум можно загрузить три ссылки на изображения.
resolution: выбор разрешения для генерируемого видео, модель veo31 поддерживает 4k разрешение, другие модели не поддерживают, все модели поддерживают 1080p и gif разрешение, если это значение не передано, по умолчанию используется разрешение 720p, основные варианты: 1080p, gif, 4k.
prompt: подсказка.
callback_url: URL для обратного вызова результата.

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

Название модели	Поддерживаемые режимы	Правила ввода изображений
veo2-fast	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	Поддерживает только 1 изображение → режим первого кадра
veo3-fast	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	1 изображение → режим первого кадра 3 изображения → режим первого и последнего кадров
veo31-fast	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	1 изображение → режим первого кадра 3 изображения → режим первого и последнего кадров
veo31-fast-ingredients	❌ Создание видео из текста (не поддерживается) ✅ Обязательное слияние нескольких изображений (изображения обязательны)	1-3 изображения → режим слияния нескольких изображений (максимум 3 изображения)
veo2	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	1 изображение → режим первого кадра 3 изображения → режим первого и последнего кадров
veo3	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	1 изображение → режим первого кадра 3 изображения → режим первого и последнего кадров
veo31	Создание видео из текста (без изображений) Создание видео из изображения (с изображениями)	1 изображение → режим первого кадра 3 изображения → режим первого и последнего кадров

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

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

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

Единственная модель, требующая обязательного ввода изображений: veo31-fast-ingredients требует передачи изображений (1-3 изображения), иначе не сможет работать.
Ограничение на количество изображений:
- За исключением veo31-fast-ingredients, другие модели поддерживают максимум 3 изображения для ввода.

После выбора вы также можете увидеть сгенерированный код справа, как показано на изображении:

Нажмите кнопку «Try», чтобы провести тестирование, как показано на изображении выше, и мы получили следующий результат:

{
  "success": true,
  "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
  "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.xhuoapi.ai/veo/dd01fc69-e1f7-4b68-aa8c-463f6b748d11.mp4",
      "created_at": "2025-07-25 16:07:43",
      "complete_at": "2025-07-25 16:10:28",
      "state": "succeeded"
    }
  ]
}

Возвращаемый результат содержит несколько полей, описание которых представлено ниже:

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

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

curl -X POST 'https://api.xhuoapi.ai/v1/veo/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "veo2",
  "prompt": "Белая керамическая кружка с кофе на блестящем мраморном столешнице при утреннем свете из окна. Камера медленно вращается на 360 градусов вокруг кружки, на мгновение останавливаясь на ручке."
}'

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

Если вы хотите сгенерировать видео на основе изображений начального и конечного кадров, вы можете установить параметр action в image2video и ввести массив ссылок на изображения начального и конечного кадров image_urls. Далее нам необходимо заполнить следующий шаг, чтобы расширить подсказки для настройки генерации видео, можно указать следующее содержимое:

model：модель для генерации видео, в основном это veo2, veo2-fast, veo3 и veo3-fast.
image_urls：при выборе действия генерации видео из изображений image2video необходимо загрузить ссылки на изображения начального и конечного кадров.
prompt：подсказка.

Пример заполнения выглядит следующим образом:

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

Соответствующий код на Python:

import requests

url = "https://api.xhuoapi.ai/v1/veo/videos"

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

payload = {
    "action": "image2video",
    "model": "veo2",
    "prompt": "Пусть танцует",
    "image_urls": ["https://cdn.xhuoapi.ai/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.xhuoapi.ai/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：модель для генерации видео, в основном это veo2, veo2-fast, veo3 и veo3-fast.
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.xhuoapi.ai/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：модель для генерации видео, в основном это veo2, veo2-fast, veo3 и veo3-fast.
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.xhuoapi.ai/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.xhuoapi.ai/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

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

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

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

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

Заключение