Skip to main content
POST
cURL
Verwenden Sie diesen Endpoint, um eine Veo 3.1-Videaufgabe zu starten. Die API gibt sofort eine Aufgaben-ID zurück. Speichern Sie daher die zurückgegebene id und fragen Sie die Aufgabe ab, bis sie einen Endstatus erreicht. POST /v1/videos verwendet multipart/form-data; übergeben Sie skalare Steuerwerte als Formularfelder und Medieneingaben als input_reference-Dateifelder.

Ein Modell auswählen

Einen Eingabemodus auswählen

Dauer und Größe festlegen

Verwenden Sie für die OpenAI-kompatible Route seconds für die Dauer und size für die Ausgabegröße. Senden Sie die Werte als Formularfelder. Setzen Sie size auf einen der folgenden WxH-Werte.

Aufgabenablauf

1

Aufgabe erstellen

Senden Sie die Multipart-Formularanfrage und speichern Sie die zurückgegebene id.
2

Aufgabe abfragen

Verwenden Sie Veo3 Retrieve, bis status completed, failed oder error ist.
3

Ergebnis herunterladen

Wenn die Aufgabe completed ist, laden Sie die MP4-Datei aus der Antwort der abgeschlossenen Aufgabe herunter.

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
model
enum<string>
erforderlich

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Verfügbare Optionen:
veo3.1-fast,
veo3.1
Beispiel:

"veo3.1-fast"

prompt
string
erforderlich

Text prompt for the video job.

Beispiel:

"A paper kite floats above a field."

seconds
enum<string>
Standard:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

Verfügbare Optionen:
4,
6,
8
Beispiel:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Beispiel:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

Antwort

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
erforderlich

Task ID. Use this value with retrieve and content endpoints.

Beispiel:

"task_example"

object
string
erforderlich

Object type. Video tasks return video.

Beispiel:

"video"

model
string
erforderlich

Model ID used for the task.

Beispiel:

"veo3.1-fast"

status
enum<string>
erforderlich

Task lifecycle status. Poll until the value is completed, failed, or error.

Verfügbare Optionen:
queued,
in_progress,
completed,
failed,
error
Beispiel:

"queued"

progress
integer
erforderlich

Task progress as a coarse percentage.

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

created_at
integer
erforderlich

Task creation time as a Unix timestamp in seconds.

Beispiel:

1779938152

task_id
string

Compatibility alias for id when present.

Beispiel:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Beispiel:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Beispiel:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.