Zum Hauptinhalt springen
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 page aus.

Wählen Sie das Anfrageformat

  • Text-zu-Video: Senden Sie keine input_reference-Dateien
  • Bild-zu-Video: Senden Sie eine input_reference
  • First-Frame- und Last-Frame-Guidance: Senden Sie zwei geordnete input_reference-Dateien

Task-Ablauf

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-Endpoint abfragen

Verwenden Sie Veo3 Retrieve, um den asynchronen Task zu verfolgen, bis er einen Endzustand erreicht.
3

Ergebnis speichern

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

Alias-Auflösung

Das Feld model in der Antwort kann statt des von Ihnen übermittelten Alias die aufgelöste Backend-Model-ID anzeigen. Verwenden Sie die Models page, um aktuelle Veo-Aliase zu finden.

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. 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