API-Referenz
Integrationsleitfäden
Fehler
Preise & Abrechnung
CometAPI-Wrapper
Asynchrone Videogenerierung
Generieren Sie Veo3-Videos asynchron über POST /v1/videos in CometAPI; dabei wird eine task id zurückgegeben und First-/Last-Frame-Steuerung für 8-Sekunden-Clips unterstützt.
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}Verwenden Sie diese Seite, um einen Veo-Job über die gemeinsame CometAPI-Route
/v1/videos zu starten. Wählen Sie beim Setzen von model einen aktuellen Veo-Alias auf der Models-Seite aus.
Anfrage-Muster auswählen
- Text-zu-Video: Senden Sie keine
input_reference-Dateien - Bild-zu-Video: Senden Sie eine
input_reference - First-Frame- und Last-Frame-Steuerung: Senden Sie zwei geordnete
input_reference-Dateien
Aufgabenablauf
Veo-Job absenden
Senden Sie einen Veo-Alias, einen Prompt und optionale Bildeingaben und speichern Sie dann die zurückgegebene
id.Gemeinsamen Video-Endpunkt abfragen
Verwenden Sie Veo3 Retrieve, um die asynchrone Aufgabe zu verfolgen, bis sie einen Endzustand erreicht.
Alias-Auflösung
Google dokumentiert Veo über die lang laufenden Video-Operationen von Gemini und verwendet Modellnamen wieveo-3.1-generate-preview. CometAPI behält die gemeinsame Route /v1/videos bei und löst zur Anfragezeit einen aktuellen Veo-Alias von der Models-Seite auf. Während der Live-Validierung am 2026-03-12 wurde eine Anfrage mit veo3-fast akzeptiert und gab eine asynchrone task id zurück, und das Antwortfeld model wurde zu einer Provider-Model-ID aufgelöst, anstatt den übermittelten Alias zurückzugeben.Autorisierungen
Bearer token authentication. Use your CometAPI key.
Body
multipart/form-data
Text prompt for the video job.
Beispiel:
"A paper kite floats above a field."
CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.
Beispiel:
"veo3-fast"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
Beispiel:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
Antwort
200 - application/json
Task accepted.
⌘I
Create a Veo video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}