Skip to main content
POST
cURL
Verwenden Sie diesen beta-Endpunkt, um eine Omni-Videoaufgabe zu erstellen. 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. Beta POST /v1/videos verwendet multipart/form-data; übergeben Sie skalare Steuerelemente als Formularfelder.

Einen Eingabemodus wählen

Verwenden Sie für diese Seite model=omni-fast.

Dauer, Verhältnis und Auflösung festlegen

Omni ist als beta gekennzeichnet, weil die Generierungsstabilität je nach Eingabe und gewählter Route variieren kann. Halten Sie die erste Anfrage klein und prüfen Sie dann das fertige Video, bevor Sie sich auf eine bestimmte gerenderte Dauer oder Frame-Größe verlassen. Da dieser Endpunkt beta ist, behandeln Sie aspect_ratio und resolution als Generierungspräferenzen und prüfen Sie die heruntergeladene MP4-Datei, bevor Sie sich auf die endgültigen Pixel verlassen.

Aufgabenablauf

1

Aufgabe erstellen

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

Aufgabe abfragen

Rufen Sie Ein Omni-Video abrufen auf, bis status den Wert completed oder failed hat.
3

Ergebnis herunterladen

Wenn die Aufgabe completed ist, rufen Sie Omni-Videoinhalt abrufen auf, um die MP4-Datei herunterzuladen.

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
model
enum<string>
erforderlich

Omni model ID for this endpoint. Use omni-fast for text-to-video.

Verfügbare Optionen:
omni-fast
Beispiel:

"omni-fast"

prompt
string
erforderlich

Text prompt that describes the video to generate.

Beispiel:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds
string
Standard:4

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

Beispiel:

"4"

aspect_ratio
enum<string>
Standard:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Verfügbare Optionen:
16:9,
9:16,
1:1
Beispiel:

"16:9"

resolution
string

Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.

Beispiel:

"720p"

Antwort

200 - application/json

Task accepted. 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:

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