Maak een Omni-video op basis van tekst, afbeelding of video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Gebruik dit beta-eindpunt om een taak voor tekst-naar-video, afbeelding-naar-video of video-naar-video te maken. De API retourneert onmiddellijk een taak-ID, dus sla de geretourneerde id op en controleer de taak periodiek totdat deze een terminale status bereikt. Kies het contenttype van de aanvraag dat overeenkomt met de invoermodus. Verzend besturingselementen voor tekst-naar-video en afbeelding-naar-video als multipart/form-data-velden. Verzend een bewerking van een referentievideo als een application/json-body.

Kies een invoermodus

Doel	Contenttype	Vereiste velden	Optionele velden
Tekst-naar-video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Afbeelding-naar-video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Video-naar-video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

De voorbeelden voor tekst-naar-video en afbeelding-naar-video gebruiken model=omni-fast. De voorbeelden voor video-naar-video gebruiken model=omni-fast-v2v. Gebruik Beschikbare modellen weergeven om te bevestigen dat een model-ID zichtbaar is voor uw API-sleutel.

Een referentieafbeelding animeren

Gebruik voor afbeelding-naar-video model=omni-fast en upload één PNG-bestand in het multipart-veld input_reference. Het veld blijft optioneel voor tekst-naar-video, maar is vereist wanneer een referentieafbeelding de gegenereerde video moet aansturen. Richt de prompt op de toe te voegen beweging en noem expliciet de kleuren, vormen, onderwerpen of compositie die het resultaat moet behouden. De selector voor codevoorbeelden bevat Shell-, Python- en JavaScript-voorbeelden die reference.png uit de werkmap uploaden en de taak maken. Deze aanvraagstructuur omvat één geüpload PNG-bestand. Deze definieert geen URL-invoer, andere afbeeldingsindelingen, meerdere referentieafbeeldingen of limieten voor bestandsgrootte.

Een referentievideo bewerken

Voor video-naar-video codeert u een lokaal MP4-bestand als base64 en voorziet u de gecodeerde bytes van het voorvoegsel data:video/mp4;base64,. Verzend de volledige data-URL in het veld video. Beschrijf de aangevraagde wijzigingen in prompt. Noem ook de onderwerpen, objecten, compositie of beweging die het resultaat moet behouden. De selector voor codevoorbeelden bevat Shell-, Python- en JavaScript-voorbeelden die reference.mp4 uit de werkmap lezen. Deze aanvraagstructuur omvat een inline MP4-data-URL. Deze definieert geen URL-invoer, andere videocontainerindelingen of limieten voor bestandsgrootte.

Duur, verhouding en resolutie instellen

Omni is gemarkeerd als bèta, omdat de generatiestabiliteit kan variëren per invoer en geselecteerde route. Houd het eerste verzoek klein en inspecteer vervolgens de voltooide video voordat u vertrouwt op een specifieke gerenderde duur of framegrootte.

Instelling	Ondersteunde waarden	Standaard	Gedrag bij grenswaarden
`seconds`	Begin met `4`	Afhankelijk van de route	Beschouw dit als een aangevraagde duur en controleer de voltooide MP4, omdat de uitvoerduur kan verschillen.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` kan portretuitvoer renderen. `1:1` kan worden geaccepteerd bij rendering in landschap.
`resolution`	Begin met `720p`; `1080p` kan worden geaccepteerd	`720p`	De huidige productie-uitvoer kan worden genormaliseerd naar `720p`, zelfs wanneer `1080p` wordt aangevraagd.

Verzoek	Waargenomen frame na voltooiing
`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`

Omdat dit endpoint bèta is, moet u aspect_ratio en resolution beschouwen als generatievoorkeuren en de gedownloade MP4 controleren voordat u op de uiteindelijke pixels vertrouwt.

Taakstroom

Taak maken

Verstuur het verzoek met het contenttype voor de geselecteerde invoermodus en sla de geretourneerde id op.

Taakstatus pollen

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

Het resultaat downloaden

Wanneer de taak completed is, roept u Omni-video-inhoud ophalen om het MP4-bestand te downloaden.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

model

string

vereist

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

Voorbeeld:

"omni-fast"

prompt

string

vereist

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

Voorbeeld:

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

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. A request for 1080p can render at 720p.

Voorbeeld:

"720p"

Respons

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_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.

Show child attributes

Laatst gewijzigd op 4 augustus 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Contentmoderatie

API-sleutels

Maak een Omni-video op basis van tekst, afbeelding of video

Kies een invoermodus

Een referentieafbeelding animeren

Een referentievideo bewerken

Duur, verhouding en resolutie instellen

Taakstroom

Autorisaties

Body

Respons

​Kies een invoermodus

​Een referentieafbeelding animeren

​Een referentievideo bewerken

​Duur, verhouding en resolutie instellen

​Taakstroom

Autorisaties

Body

Respons

Kies een invoermodus

Een referentieafbeelding animeren

Een referentievideo bewerken

Duur, verhouding en resolutie instellen

Taakstroom