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

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'

200

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

1. Veo-Job absenden

   Senden Sie einen Veo-Alias, einen Prompt und optionale Bildeingaben und speichern Sie dann die zurückgegebene id.

2. Gemeinsamen Video-Endpunkt abfragen

   Verwenden Sie Veo3 Retrieve, um die asynchrone Aufgabe zu verfolgen, bis sie einen Endzustand erreicht.

3. Ergebnis speichern

   Verschieben Sie das fertige Asset in Ihren eigenen Speicher, wenn Ihre Anwendung eine dauerhafte Kopie benötigt.

​

Alias-Auflösung

Google dokumentiert Veo über die lang laufenden Video-Operationen von Gemini und verwendet Modellnamen wie veo-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

Authorization · string · header · erforderlich

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt · string · erforderlich

Text prompt for the video job.

Beispiel:

"A paper kite floats above a field."

model · string · Standard: veo3-fast

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"

size · string

Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

Beispiel:

"16x9"

input_reference · file

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.

created_at · integer · erforderlich

id · string · erforderlich

model · string · erforderlich

Provider model identifier resolved by CometAPI for this task.

object · string · erforderlich

progress · integer · erforderlich

seconds · string · erforderlich

size · string · erforderlich

status · string · erforderlich