Maestro Video-Generierungs-API Integrationsanleitung

​

Antragsprozess

📘 Vollständige Dokumentation: Maestro Video-Generierungs-API →

​

Grundlegende Nutzung

• accept: In welchem Format Sie die Antwort erhalten möchten, hier als application/json, also im JSON-Format.
• authorization: Der Schlüssel zur API-Nutzung, den Sie nach der Beantragung direkt auswählen können.
• content-type: Das Format des Request-Bodys, hier als application/json.

• prompt: Beschreiben Sie das Video in natürlicher Sprache (Thema, was gezeigt werden soll, Stil, Zielgruppe).
• langs: Array der Ausgabesprachen, wie ["zh-cn", "en"], standardmäßig ["zh-cn"].
• aspect: Bildverhältnis, 9:16 (Standard) / 16:9 / 1:1.
• duration: Zielzeit (Sekunden), standardmäßig 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：Ob die Aufgabe erfolgreich eingereicht wurde.
• task_id：Die ID der aktuellen Videoerzeugungsaufgabe, die später zur Abfrage der Ergebnisse über die Maestro Aufgabenabfrage API verwendet wird.
• trace_id：Die Verfolgungs-ID dieser Anfrage, die bei Problemen dem technischen Support zur Lokalisierung bereitgestellt werden kann.

​

Bestimmen des Video-Typs und -Stils (scenario / style)

• scenario：Video-Typ, hier auf drama (Charaktere + Dialoge des Kurzdramas) gesetzt.
• style：Visueller Stil, hier auf cinematic (filmische Qualität) gesetzt.

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "Zwei Mitbewohner streiten sich wegen einer Katze und versöhnen sich wieder, drei Akte mit Wendungen, das Ende ist warmherzig",
  "scenario": "drama",
  "style": "cinematic",
  "aspect": "9:16",
  "duration": 40
}'

• Erzählvideo: scenario: "narrated", Lite / Standard / Pro unterstützen alle.
• Automatische Untertitel: scenario: "captions", erfordert file_urls für das Quellvideo, Lite / Standard / Pro unterstützen alle.
• Digitale Menschen / Voiceover: scenario: "avatar", erfordert file_urls für ein Porträt, Standard / Pro unterstützen.
• Kurzdrama: scenario: "drama" (Charaktere + Dialoge), nur Pro unterstützt.
• style ist eine visuelle Stilvorgabe (z. B. modern / neon / luxury), ändert den Typ nicht, beeinflusst nur die Wahrnehmung.
• voice wird verwendet, um den Erzählton anzugeben (z. B. warm-female / deep-male), unabhängig von der Sprache, sprachübergreifend.

​

Mehrsprachige Ausgabe

curl -X POST 'https://api.acedata.cloud/maestro/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "Stellen Sie unser intelligentes Kundenservice-Produkt vor und heben Sie 3 Kernmerkmale hervor",
  "langs": ["zh-cn", "en", "ja"],
  "aspect": "16:9",
  "duration": 30
}'

​

Iteration auf bestehenden Videos (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": "Ändern Sie den Eröffnungstitel in einen eindrucksvolleren Satz, die gesamte Farbgebung etwas dunkler"
}'

• remix：Das ursprüngliche Video wird neu interpretiert (Thema beibehalten, Darstellung angepasst).
• edit：Feinbearbeitung eines bestimmten Teils (z. B. Titel ändern, Sprachaufnahme ändern, Farbkorrektur).
• extend：Inhalt auf der Grundlage des ursprünglichen Videos erweitern.

​

Ergebnisse abrufen

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

​

Abrechnung

Punkte = Dauer des Endprodukts in Sekunden × 0.60 × Szenenmultiplikator + 6 × max(Anzahl der Sprachen − 1, 0)

​

Fehlerbehandlung

• 400 invalid_request：Ungültige Anfrage, möglicherweise aufgrund eines fehlenden prompt oder ungültiger Parameter.
• 401 invalid_token：Unbefugt, ungültiges oder fehlendes Autorisierungstoken.
• 403 forbidden：Verboten, unzureichendes Guthaben oder Zugriff.
• 429 too_many_requests：Zu viele Anfragen, Sie haben das Rate-Limit überschritten.
• 500 api_error：Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

​

Beispiel für eine Fehlerantwort

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "Abruf fehlgeschlagen"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Schlussfolgerung

​

Verwandte Schnittstellen

• Maestro Aufgabenabfrage API Integrationsanleitung: Verwenden Sie POST /maestro/videos, um den task_id den Status und die Ergebnisse der Aufgabe abzufragen oder eine Liste historischer Aufgaben abzurufen (Polling kostenlos).