Maestro Видео Генерации API Инструкция по Интеграции

​

Процесс Заявки

📘 Полная документация: Maestro Видео Генерации API →

​

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

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

• prompt: описание видео на естественном языке (тема, что показывать, стиль, аудитория).
• langs: массив языков вывода, например, ["zh-cn", "en"], по умолчанию ["zh-cn"].
• aspect: соотношение сторон, 9:16 (по умолчанию) / 16:9 / 1:1.
• duration: целевая продолжительность (в секундах), по умолчанию 30.

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "用 20 秒讲清楚什么是向量数据库，适合零基础观众，结尾给一句记忆点",
  "langs": ["zh-cn", "en"],
  "aspect": "9:16",
  "duration": 20
}'

import requests

url = "https://api.acedata.cloud/maestro/videos"

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

payload = {
    "prompt": "用 20 秒讲清楚什么是向量数据库，适合零基础观众，结尾给一句记忆点",
    "langs": ["zh-cn", "en"],
    "aspect": "9:16",
    "duration": 20
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

{
  "success": true,
  "task_id": "f57e99c4f60f4373a15517742ce2357d",
  "trace_id": "70e1cb12-c619-4292-a416-90191205996b"
}

• success：Успешно ли была отправлена задача.
• task_id：ID задачи на генерацию видео, который будет использоваться для опроса результатов через API запроса задач Maestro.
• trace_id：ID отслеживания данного запроса, который можно предоставить технической поддержке для диагностики проблем.

​

Указание типа и стиля видео (scenario / style)

• scenario：Тип видео, здесь установлено drama (короткометражный фильм с персонажами и диалогами).
• style：Визуальный стиль, здесь установлен cinematic (кинематографическое качество).

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "Два соседа по квартире поссорились из-за кота, но затем помирились, три акта с поворотами, в конце тепло",
  "scenario": "drama",
  "style": "cinematic",
  "aspect": "9:16",
  "duration": 40
}'

• Объяснительное видео: scenario: "narrated", поддерживается Lite / Standard / Pro.
• Автоматические субтитры: scenario: "captions", необходимо передать исходное видео через file_urls, поддерживается Lite / Standard / Pro.
• Цифровой человек / озвучка: scenario: "avatar", необходимо передать одно изображение через file_urls, поддерживается Standard / Pro.
• Короткометражный фильм: scenario: "drama" (персонажи + диалоги), поддерживается только Pro.
• style — это предустановленный визуальный стиль (например, modern / neon / luxury), не меняет тип, только влияет на восприятие.
• voice используется для указания тона голоса (например, warm-female / deep-male), не зависит от языка, универсален для разных языков.

​

Многоязычный вывод

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "Представьте наш продукт интеллектуального обслуживания клиентов, выделите 3 ключевых преимущества",
  "langs": ["zh-cn", "en", "ja"],
  "aspect": "16:9",
  "duration": 30
}'

​

Итерация на существующем видео (remix / edit / extend)

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "remix",
  "ref_task_id": "f57e99c4f60f4373a15517742ce2357d",
  "prompt": "Замените заголовок начала на более эффектную фразу, сделайте общую цветовую гамму темнее"
}'

• remix：Переосмысление структуры оригинального видео (сохранение темы, изменение подачи).
• edit：Точная доработка определенной части (например, замена заголовка, замена озвучки, коррекция цвета).
• extend：Расширение содержания на основе оригинального видео.

​

Получение результатов

curl -X POST 'https://api.acedata.cloud/maestro/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "f57e99c4f60f4373a15517742ce2357d"
}'

​

Оплата

Очки = Продолжительность видео в секундах × 0.60 × Множитель сцены + 6 × max(Количество языков − 1, 0)

​

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

• 400 invalid_request：Неверный запрос, возможно, из-за отсутствия prompt или неверных параметров.
• 401 invalid_token：Неавторизованный, неверный или отсутствующий токен авторизации.
• 403 forbidden：Запрещено, недостаточно средств или доступа.
• 429 too_many_requests：Слишком много запросов, вы превысили лимит частоты.
• 500 api_error：Внутренняя ошибка сервера, что-то пошло не так на сервере.

​

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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "не удалось получить данные"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Заключение

​

Связанные интерфейсы

• Описание интеграции API запроса задач Maestro: используйте POST /maestro/videos, чтобы получить task_id для проверки статуса и результатов задачи или для получения списка историй задач (бесплатное опрашивание).