Инструкция по интеграции Veo Videos Generation API

​

Процесс получения доступа

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

​

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

• 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, после чего результат получается путем опроса соответствующего интерфейса запроса задач.

​

📌 Сводка описания моделей

​

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

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

• Режим 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://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，статус задачи генерации видео на данный момент。

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."
}'

​

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

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

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

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

​

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

• 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"
    }
  ]
}

​

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

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

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

​

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

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

​

Заключение