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

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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