Opprett en Omni-video fra tekst, bilde eller video

Bruk dette betaendepunktet til å opprette en tekst-til-video-, bilde-til-video- eller video-til-video-oppgave. API-et returnerer umiddelbart en oppgave-ID, så lagre den returnerte id og hent oppgavestatusen regelmessig til den når en sluttstatus. Velg innholdstypen for forespørselen som samsvarer med inndatamodusen. Send kontroller for tekst-til-video og bilde-til-video som multipart/form-data-felt. Send en redigering av referansevideo som en application/json-forespørselstekst.

Velg en inndatamodus

Mål	Innholdstype	Obligatoriske felt	Valgfrie felt
Tekst-til-video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Bilde-til-video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Video-til-video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Eksemplene for tekst-til-video og bilde-til-video bruker model=omni-fast. Eksemplene for video-til-video bruker model=omni-fast-v2v. Bruk Vis tilgjengelige modeller for å bekrefte at en modell-ID er synlig for API-nøkkelen din.

Animer et referansebilde

For bilde-til-video bruker du model=omni-fast og laster opp én PNG-fil i multipart-feltet input_reference. Feltet er fortsatt valgfritt for tekst-til-video, men det er obligatorisk når et referansebilde skal styre den genererte videoen. Fokuser prompt på bevegelsen som skal legges til, og angi eksplisitt fargene, formene, motivene eller komposisjonen som resultatet skal bevare. Kodeeksempelvelgeren inneholder eksempler for Shell, Python og JavaScript som laster opp reference.png fra arbeidskatalogen og oppretter oppgaven. Denne forespørselsformen dekker én opplastet PNG. Den definerer ikke URL-inndata, andre bildeformater, flere referansebilder eller filstørrelsesgrenser.

Rediger en referansevideo

For video-til-video koder du en lokal MP4-fil som base64 og legger til data:video/mp4;base64, foran de kodede bytene. Send hele data-URL-en i feltet video. Beskriv de ønskede endringene i prompt. Angi også motivene, objektene, komposisjonen eller bevegelsen som resultatet skal bevare. Kodeeksempelvelgeren inneholder eksempler for Shell, Python og JavaScript som leser reference.mp4 fra arbeidskatalogen. Denne forespørselsformen dekker en innebygd MP4-data-URL. Den definerer ikke URL-inndata, andre videobeholderformater eller filstørrelsesgrenser.

Angi varighet, sideforhold og oppløsning

Omni er merket som beta fordi genereringsstabiliteten kan variere etter inndata og valgt rute. Hold den første forespørselen liten, og kontroller deretter den fullførte videoen før du stoler på en bestemt gjengitt varighet eller bildestørrelse.

Innstilling	Støttede verdier	Standardverdi	Atferd ved grenseverdier
`seconds`	Start med `4`	Avhenger av rute	Behandle dette som en forespurt varighet, og kontroller den fullførte MP4-filen fordi utdataenes varighet kan avvike.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` kan gjengi utdata i stående format. `1:1` kan godtas mens gjengivelsen skjer i liggende format.
`resolution`	Start med `720p`; `1080p` kan godtas	`720p`	Nåværende produksjonsutdata kan normaliseres til `720p` selv når `1080p` er forespurt.

Forespørsel	Observert fullført bilde
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Fordi dette endepunktet er i beta, bør du behandle aspect_ratio og resolution som genereringspreferanser og kontrollere den nedlastede MP4-filen før du er avhengig av de endelige pikslene.

Oppgaveflyt

Opprett oppgaven

Send forespørselen med innholdstypen for den valgte inndatamodusen, og lagre den returnerte id.

Spør oppgaven regelmessig

Kall Hent en Omni-video til status er completed eller failed.

Last ned resultatet

Når oppgaven er completed, kaller du Hent Omni-videoinnhold for å laste ned MP4-filen.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

model

string

påkrevd

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

Eksempel:

"omni-fast"

prompt

string

påkrevd

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Eksempel:

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

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Eksempel:

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

Tilgjengelige alternativer:

16:9,

9:16,

1:1

Eksempel:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Eksempel:

"720p"

Svar

200 - application/json

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

string

påkrevd

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

Eksempel:

"task_example"

object

string

påkrevd

Object type. Video tasks return video.

Eksempel:

"video"

model

string

påkrevd

Model ID used for the task.

Eksempel:

"omni-fast"

status

enum<string>

påkrevd

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

Tilgjengelige alternativer:

queued,

in_progress,

completed,

failed,

error

Eksempel:

"queued"

progress

integer

påkrevd

Task progress as a coarse percentage.

Nødvendig område: 0 <= x <= 100

Eksempel:

0

created_at

integer

påkrevd

Task creation time as a Unix timestamp in seconds.

Eksempel:

1779938152

task_id

string

Compatibility alias for id when present.

Eksempel:

"task_example"

completed_at

integer

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

Eksempel:

1779938219

video_url

string

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

Eksempel:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Innholdsmoderering

API-nøkler

Opprett en Omni-video fra tekst, bilde eller video

Velg en inndatamodus

Animer et referansebilde

Rediger en referansevideo

Angi varighet, sideforhold og oppløsning

Oppgaveflyt

Autorisasjoner

Kropp

Svar

​Velg en inndatamodus

​Animer et referansebilde

​Rediger en referansevideo

​Angi varighet, sideforhold og oppløsning

​Oppgaveflyt

Autorisasjoner

Kropp

Svar

Velg en inndatamodus

Animer et referansebilde

Rediger en referansevideo

Angi varighet, sideforhold og oppløsning

Oppgaveflyt