Zum Hauptinhalt springen
Dieser Artikel beschreibt eine Integrationsanleitung für die Veo Videos Generation API, die es ermöglicht, offizielle Veo-Videos durch Eingabe benutzerdefinierter Parameter zu generieren.

​
Antragsprozess

Um die API zu nutzen, müssen Sie zunächst auf die entsprechende Seite der Veo Videos Generation API gehen und den entsprechenden Dienst beantragen. Nach dem Betreten der Seite klicken Sie auf die Schaltfläche „Acquire“, wie im Bild gezeigt: Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung werden Sie automatisch zur aktuellen Seite zurückgeleitet. Bei der ersten Beantragung gibt es ein kostenloses Kontingent, mit dem Sie die API kostenlos nutzen können.

​
Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, indem Sie die Eingabeaufforderung prompt, die Generierungsaktion action, das Array der Referenzbilder für den ersten und letzten Frame image_urls sowie das Modell model eingeben, um das verarbeitete Ergebnis zu erhalten. Zunächst müssen Sie ein einfaches action-Feld übergeben, dessen Wert text2video ist. Es gibt hauptsächlich drei Aktionen: Text zu Video (text2video), Bild zu Video (image2video), 1080p-Video abrufen (get1080p). Dann müssen wir auch das Modell model eingeben, das derzeit hauptsächlich die Modelle veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients und veo3-fast umfasst. Die genauen Inhalte sind wie folgt:

Hier haben wir die Request-Header festgelegt, einschließlich:
  • accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
  • authorization: Der Schlüssel zur API-Nutzung, den Sie nach der Beantragung direkt auswählen können.
Zusätzlich haben wir den Request-Body festgelegt, einschließlich:
  • model: Das Modell zur Videoerzeugung, hauptsächlich veo2, veo2-fast, veo3, veo31, veo31-fast, veo31-fast-ingredients und veo3-fast.
  • action: Die Aktion dieser Videoerzeugungsaufgabe, die hauptsächlich drei Aktionen umfasst: Text zu Video (text2video), Bild zu Video (image2video), 1080p-Video abrufen (get1080p).
  • image_urls: Wenn die Aktion Bild zu Video (image2video) gewählt wird, müssen die Links zu den Referenzbildern für den ersten und letzten Frame hochgeladen werden, maximal drei Referenzbilder.
  • resolution: Wählen Sie die Auflösung des zu generierenden Videos, wobei das veo31-Modell 4k-Auflösung unterstützt, andere Modelle nicht. Alle Modelle unterstützen 1080p und gif-Auflösung. Wenn dieser Wert nicht übergeben wird, wird standardmäßig 720p verwendet, hauptsächlich unterteilt in: 1080p, gif, 4k.
  • prompt: Eingabeaufforderung.
  • callback_url: Die URL, an die das Ergebnis zurückgerufen werden soll.

​
📌 Zusammenfassung der Modellbeschreibung

ModellnameUnterstützte ModiBild-Eingaberegeln
veo2-fastText zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		Unterstützt nur 1 Bild → Erstes Frame-Modus
veo3-fastText zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		1 Bild → Erstes Frame-Modus
3 Bilder → Erstes und letztes Frame-Modus
veo31-fastText zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		1 Bild → Erstes Frame-Modus
3 Bilder → Erstes und letztes Frame-Modus
veo31-fast-ingredients❌ Text zu Video (nicht unterstützt)
✅ Zwang zur Mehrbildfusion (Bilder müssen übergeben werden)		1-3 Bilder → Mehrbildfusionsmodus (maximal 3 Bilder)
veo2Text zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		1 Bild → Erstes Frame-Modus
3 Bilder → Erstes und letztes Frame-Modus
veo3Text zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		1 Bild → Erstes Frame-Modus
3 Bilder → Erstes und letztes Frame-Modus
veo31Text zu Video (ohne Bild)
Bild zu Video-Modus (mit Bild)		1 Bild → Erstes Frame-Modus
3 Bilder → Erstes und letztes Frame-Modus

​
🔑 Erklärung der Schlüsselregeln

  1. Allgemeine Logik:
    • Keine Bild-Eingabe → Automatischer Trigger für den Text zu Video-Modus.
    • Bild-Eingabe vorhanden → Trigger für den Bild zu Video-Modus (konkretes Verhalten hängt von der Anzahl der Bilder ab).
  2. Typen des Bild zu Video-Modus:
    • Erstes Frame-Modus (1 Bild): Erstes Frame ist das eingegebene Bild.
    • Erstes und letztes Frame-Modus (2 Bilder): Erstes und letztes Frame sind die eingegebenen Bilder.
    • Mehrbildfusionsmodus (1-3 Bilder): Nur veo31-fast-ingredients unterstützt dies, um Inhalte mehrerer Bilder zu fusionieren und ein Video zu generieren.
  3. Modus-Kategorisierung:
    • Schnell-Modus: veo2-fast, veo3-fast, veo31-fast, veo31-fast-ingredients.
    • Qualitäts-Modus: veo2, veo3, veo31 (höhere Generierungsqualität).

​
⚠️ Hinweise

  • Einziges Modell mit zwingender Bildübertragung: veo31-fast-ingredients muss Bilder übergeben (1-3 Bilder), sonst kann es nicht ausgeführt werden.
  • Bildanzahl-Beschränkung:
    • Abgesehen von veo31-fast-ingredients unterstützen andere Modelle maximal 3 Bilder als Eingabe.
Nach der Auswahl können Sie feststellen, dass auf der rechten Seite auch der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen, wie im obigen Bild gezeigt, und wir erhalten folgendes Ergebnis: 
{
  "success": true,
  "task_id": "dd01fc69-e1f7-4b68-aa8c-463f6b748d11",
  "trace_id": "9906dac0-1516-41dc-9fe3-067ca1ba8269",
  "data": [
    {
      "id": "253eedc47f1c4eb2a370ed2312168f4b",
      "video_url": "https://platform.cdn.acedata.cloud/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"
    }
  ]
}
Die Rückgabeergebnisse umfassen mehrere Felder, die wie folgt beschrieben werden:
  • success，der Status des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • task_id，die ID des Videoerstellungsauftrags zu diesem Zeitpunkt.
  • data，das Ergebnis des Videoerstellungsauftrags zu diesem Zeitpunkt.
    • id，die Video-ID des Videoerstellungsauftrags zu diesem Zeitpunkt.
    • video_url，der Video-Link des Videoerstellungsauftrags zu diesem Zeitpunkt.
    • created_at，die Erstellungszeit des Videoerstellungsauftrags zu diesem Zeitpunkt.
    • complete_at，die Abschlusszeit des Videoerstellungsauftrags zu diesem Zeitpunkt.
    • state，der Status des Videoerstellungsauftrags zu diesem Zeitpunkt.
Wir können sehen, dass wir die gewünschten Videoinformationen erhalten haben, wir müssen nur den Video-Link aus dem Ergebnis data abrufen, um das generierte Veo-Video zu erhalten. Wenn Sie den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel ist der CURL-Code wie folgt: 
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": "veo2",
  "prompt": "Weißer Keramikkaffeebecher auf glänzendem Marmorarbeitsplatte mit Morgenfensterlicht. Die Kamera dreht sich langsam 360 Grad um den Becher und hält kurz am Griff an."
}'

​
Bild-zu-Video-Funktion

Wenn Sie ein Video basierend auf den ersten und letzten Bildrahmen erstellen möchten, können Sie den Parameter action auf image2video setzen und ein Array von Bild-URLs für die ersten und letzten Bildrahmen eingeben. Als nächstes müssen wir die nächsten Schritte ausfüllen, um die Eingabeaufforderung anzupassen, um das Video zu generieren, und können die folgenden Inhalte angeben:
  • model：das Modell zur Videoerstellung, hauptsächlich veo2 、veo2-fast、veo3 und veo3-fast.
  • image_urls：Wenn Sie die Bild-zu-Video-Aktion image2video auswählen, müssen Sie die Referenzbilder für die ersten und letzten Bildrahmen hochladen.
  • prompt：Eingabeaufforderung.
Ein Beispiel für die Eingabe sieht wie folgt aus:

Nachdem Sie die Eingabe abgeschlossen haben, wurde automatisch der folgende Code generiert:

Der entsprechende Python-Code: 
import requests

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

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

payload = {
    "action": "image2video",
    "model": "veo2",
    "prompt": "Lass es tanzen",
    "image_urls": ["https://cdn.acedata.cloud/7p1jhy.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
Wenn Sie auf Ausführen klicken, können Sie ein Ergebnis erhalten, wie folgt: 
{
  "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"
    }
  ]
}
Es ist zu erkennen, dass der Inhalt des Ergebnisses mit dem oben genannten übereinstimmt, was die Bild-zu-Video-Funktion des Videos realisiert.

​
1080p-Video-Funktion abrufen

Wenn Sie ein bereits generiertes Veo-Video in 1080p abrufen möchten, können Sie den Parameter action auf get1080p setzen und die ID des Videos eingeben, das Sie in 1080p abrufen möchten. Die Video-ID wird basierend auf der grundlegenden Verwendung abgerufen, wie im folgenden Bild gezeigt:

Zu diesem Zeitpunkt können Sie die Video-ID sehen: 
"id": "59f12222b1fa4fbe9331ff2400ad1583"
Hinweis: Hier ist die video_id im Video die ID des nach der Erstellung generierten Videos. Wenn Sie nicht wissen, wie Sie ein Video erstellen, können Sie sich auf die grundlegende Verwendung im obigen Text beziehen, um ein Video zu erstellen.
Als nächstes müssen wir die nächsten Schritte ausfüllen, um die Eingabeaufforderung anzupassen, um das Video zu generieren, und können die folgenden Inhalte angeben:
  • model：das Modell zur Videoerstellung, hauptsächlich veo2 、veo2-fast、veo3 und veo3-fast.
  • video_id：die Referenz-Video-ID, um das 1080p-Video abzurufen.
Ein Beispiel für die Eingabe sieht wie folgt aus:

Nachdem Sie die Eingabe abgeschlossen haben, wurde automatisch der folgende Code generiert:

Wenn Sie auf Ausführen klicken, können Sie ein Ergebnis erhalten, wie folgt: 
{
  "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"
    }
  ]
}
Es ist zu erkennen, dass der Inhalt des Ergebnisses mit dem oben genannten übereinstimmt, was die Funktion zum Abrufen des 1080p-Videos realisiert.

​
Generierung eines Videos mit festgelegten Abmessungen

Wenn Sie ein Veo-Video mit benutzerdefinierten Abmessungen erstellen möchten, können Sie den Parameter aspect_ratio auf die gewünschte Größe setzen. Als nächstes müssen wir die nächsten Schritte ausfüllen, um die Eingabeaufforderung anzupassen, um das Video zu generieren, und können die folgenden Inhalte angeben:
  • model：das Modell zur Videoerstellung, hauptsächlich veo2 、veo2-fast、veo3 und veo3-fast.
  • aspect_ratio：die Größe des Videos, derzeit unterstützt: 16:9、16:9、3:4、4:3、1:1，standardmäßig ist 16:9.
  • translation：ob die automatische Übersetzung der Eingabeaufforderung aktiviert werden soll, standardmäßig ist false. Ein Beispiel für die Eingabe sieht wie folgt aus:

Nachdem Sie die Eingabe abgeschlossen haben, wurde automatisch der folgende Code generiert:

Wenn Sie auf Ausführen klicken, können Sie ein Ergebnis erhalten, wie folgt: 
{
  "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"
    }
  ]
}
Es ist zu erkennen, dass der Ergebnisinhalt mit dem obigen übereinstimmt, was die Funktion zur Generierung von Videos in einer bestimmten Größe realisiert.

​
Asynchrone Rückrufe

Da die von der Veo Videos Generation API benötigte Zeit relativ lang ist, etwa 1-2 Minuten, bleibt die HTTP-Anfrage bei längerer Nichtreaktion der API verbunden, was zu einem zusätzlichen Verbrauch von Systemressourcen führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Ablauf ist: Wenn der Client die Anfrage stellt, gibt er zusätzlich ein Feld callback_url an. Nachdem der Client die API-Anfrage gestellt hat, gibt die API sofort ein Ergebnis zurück, das Informationen über ein task_id-Feld enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, wird das Ergebnis der Videoerstellung in Form von POST JSON an die vom Client angegebene callback_url gesendet, wobei auch das task_id-Feld enthalten ist, sodass die Aufgabenergebnisse über die ID miteinander verknüpft werden können. Lassen Sie uns anhand eines Beispiels verstehen, wie dies konkret funktioniert. Zunächst ist der Webhook-Rückruf ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten die URL ihres eigenen HTTP-Servers angeben. Hier verwenden wir zur Veranschaulichung eine öffentliche Webhook-Beispielwebsite https://webhook.site/, auf der Sie eine Webhook-URL erhalten können, wie im Bild gezeigt: Kopieren Sie diese URL, um sie als Webhook zu verwenden. Das Beispiel hier lautet https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc. Als Nächstes können wir das Feld callback_url auf die oben genannte Webhook-URL setzen und die entsprechenden Parameter ausfüllen, wie im Bild gezeigt:

Klicken Sie auf Ausführen, und Sie werden sofort ein Ergebnis erhalten, wie folgt: 
{
  "task_id": "1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"
}
Warten Sie einen Moment, und wir können das Ergebnis der Videoerstellung unter https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dc beobachten, wie im Bild gezeigt: Der Inhalt lautet: 
{
  "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"
    }
  ]
}
Es ist zu sehen, dass im Ergebnis ein task_id-Feld vorhanden ist, und die anderen Felder sind ähnlich wie oben, sodass die Aufgabenverknüpfung über dieses Feld realisiert werden kann.

​
Fehlerbehandlung

Wenn beim Aufruf der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen zurück. Zum Beispiel:
  • 400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 401 invalid_token: Unbefugt, ungültiger oder fehlender Autorisierungstoken.
  • 429 too_many_requests: Zu viele Anfragen, Sie haben das Kontingent überschritten.
  • 500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

​
Beispiel für eine Fehlerantwort

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

​
Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die Veo Videos Generation API verwenden können, um Videos durch Eingabe von Stichwörtern und einem Referenzbild des ersten Frames zu generieren. Wir hoffen, dass dieses Dokument Ihnen hilft, die API besser zu integrieren und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.