Skip to main content
POST
cURL
Gebruik dit beta-endpoint om een Omni-videotaak te maken. De API retourneert direct een taak-ID, dus sla de geretourneerde id op en poll de taak totdat deze een terminale status bereikt. Beta POST /v1/videos gebruikt multipart/form-data; geef scalaire instellingen door als formuliervelden.

Kies een invoermodus

Gebruik model=omni-fast voor deze pagina.

Stel duur, verhouding en resolutie in

Omni is als beta gemarkeerd omdat de stabiliteit van de generatie kan variëren per invoer en geselecteerde route. Houd het eerste verzoek klein en inspecteer daarna de voltooide video voordat je vertrouwt op een specifieke gerenderde duur of framegrootte. Omdat dit endpoint beta is, moet je aspect_ratio en resolution behandelen als generatievoorkeuren en het gedownloade MP4-bestand controleren voordat je afhankelijk bent van de uiteindelijke pixels.

Taakverloop

1

Maak de taak

Verstuur het multipart-formulierverzoek en sla de geretourneerde id op.
2

Poll de taak

Roep Een Omni-video ophalen aan totdat status completed of failed is.
3

Download het resultaat

Wanneer de taak completed is, roep je Omni-video-inhoud ophalen aan om het MP4-bestand te downloaden.

Autorisaties

Authorization
string
header
vereist

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data
model
enum<string>
vereist

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

Beschikbare opties:
omni-fast
Voorbeeld:

"omni-fast"

prompt
string
vereist

Text prompt that describes the video to generate.

Voorbeeld:

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

seconds
string
standaard:4

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

Voorbeeld:

"4"

aspect_ratio
enum<string>
standaard: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.

Beschikbare opties:
16:9,
9:16,
1:1
Voorbeeld:

"16:9"

resolution
string

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

Voorbeeld:

"720p"

Respons

200 - application/json

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

id
string
vereist

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

Voorbeeld:

"task_example"

object
string
vereist

Object type. Video tasks return video.

Voorbeeld:

"video"

model
string
vereist

Model ID used for the task.

Voorbeeld:

"omni-fast"

status
enum<string>
vereist

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

Beschikbare opties:
queued,
in_progress,
completed,
failed,
error
Voorbeeld:

"queued"

progress
integer
vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100
Voorbeeld:

0

created_at
integer
vereist

Task creation time as a Unix timestamp in seconds.

Voorbeeld:

1779938152

task_id
string

Compatibility alias for id when present.

Voorbeeld:

"task_example"

completed_at
integer

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

Voorbeeld:

1779938219

video_url
string

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

Voorbeeld:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.