Opprett en Flux 3-video

POST

videos

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Opprett en Flux 3-video fra tekst, referansebilder eller første og siste bilde. Lagre den returnerte id for å spørre oppgaven regelmessig og laste ned den fullførte videoen. POST /v1/videos bruker multipart/form-data. Send kontroller som skjemafelt. For bildeinndata bruker du URL-er til referansebilder eller åpnings- og sluttbilder. Hold input_reference atskilt fra first_frame og last_frame.

Velg en inndatamodus

Mål	Obligatoriske felt	Valgfrie felt
Tekst-til-video	`model=flux-3`, `prompt`	`seconds`, `size`
HTTPS bilde-til-video	`model=flux-3`, `prompt`, én `input_reference`-URL	`seconds`, `size`
Ordnete nøkkelbilder	`model=flux-3`, `prompt`, gjentatte `input_reference`-URL-er	`seconds`, `size`
Opplastet åpningsbilde	`model=flux-3`, `prompt`, én `first_frame`-fil	`seconds`, `size`
Video med første og siste bilde	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Bruk referansebilder

Feltet input_reference godtar bare offentlig tilgjengelige HTTPS-URL-er til bilder. Send det én gang for ett enkelt bilde, eller gjenta det i nøkkelbilderekkefølge for flere bilder. Bruk én URL per felt, opptil 10 URL-er totalt. Beskriv bevegelsen, kamerabevegelsen og de visuelle detaljene som den genererte videoen skal bevare fra referansebildet. Forespørselseksemplene øverst på denne siden viser inndata med ett bilde og flere bilder. Den følgende forespørselen bruker to bilder i den innsendte rekkefølgen:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=Move smoothly through the supplied reference images in their given order. Preserve recognizable subjects and visual details as the scene changes. Keep the camera movement gentle.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569429.png' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569420.png'

Angi første og siste bilde

Send first_frame for å angi åpningsbildet. For også å angi sluttbildet inkluderer du last_frame og beskriver bevegelsen mellom de to bildene i prompt. For bare et åpningsbilde utelater du last_frame. Et sluttbilde krever både first_frame og last_frame. Hvert felt godtar én offentlig tilgjengelig HTTPS-URL eller én PNG- eller JPEG-fil. Send hvert felt én gang, enten med en URL eller en fil. Hold hver fil på eller under 20 MiB (20 × 1024 × 1024 byte). Bildeeksemplene øverst på denne siden viser URL-inndata og filopplastinger, med seconds og size angitt eksplisitt.

Angi varighet og størrelse

Angi seconds eksplisitt som et heltall fra 5 til og med 20. Angi size til én av disse nøyaktige forhåndsinnstilte WxH-verdiene:

Oppløsningstrinn	Størrelse
`720p`	`1280x720`
`1080p`	`1920x1080`

Størrelsesverdien velger utdataoppløsningstrinnet. For tekst-til-video kan kodede dimensjoner justeres for kodekjustering. For bilde-til-video kan referansebildet også bestemme den endelige innrammingen og bildesideforholdet.

Oppgaveflyt

Opprett oppgaven

Send multipart-skjemaforespørselen og lagre den returnerte id.

Kontroller oppgaven regelmessig

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

Last ned resultatet

Når oppgaven er completed, kaller du Last ned Flux 3-videoinnhold for å lagre MP4-filen.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

multipart/form-data

Flux 3 multipart request. Choose text, input_reference URLs, or first_frame and last_frame inputs. Keep reference-image and frame inputs separate.

model

string

standard:flux-3

påkrevd

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

standard:A paper boat glides across a still pond while the camera moves forward.

påkrevd

Text that describes the scene, motion, camera behavior, and visual details that the video should preserve.

Minimum string length: 1

seconds

integer

Requested clip duration in whole seconds. Set seconds explicitly to an integer from 5 through 20.

Nødvendig område: 5 <= x <= 20

size

enum<string>

standard:1280x720

Resolution preset in exact WxH form. Use 1280x720 for the 720p tier or 1920x1080 for the 1080p tier. Encoded dimensions can be codec-aligned; image-to-video framing can follow the reference image.

Tilgjengelige alternativer:

1280x720,

1920x1080

input_reference

Reference image URLs. Send one publicly accessible HTTPS image URL per input_reference field. For multiple images, repeat the field in keyframe order, up to 10 URLs. This field accepts URLs only. Keep it separate from first_frame and last_frame.

Pattern: ^https://

first_frame

Opening-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. Pair with last_frame to set both boundaries. Keep frame inputs separate from input_reference.

Pattern: ^https://

last_frame

Closing-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. To specify the closing image through this endpoint, send last_frame together with first_frame. Keep frame inputs separate from input_reference.

Pattern: ^https://

Svar

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

string

påkrevd

Task ID. Use this value as task_id in retrieve and content requests.

Eksempel:

"<task_id>"

object

string

påkrevd

Object type for the asynchronous video task.

Allowed value: "video"

model

string

påkrevd

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

påkrevd

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

Tilgjengelige alternativer:

queued,

in_progress,

completed,

failed

progress

integer

påkrevd

Task progress as a coarse percentage.

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

created_at

integer<int64>

påkrevd

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

Eksempel:

"<task_id>"

completed_at

integer<int64>

Task completion time as a Unix timestamp in seconds when the task provides one.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

Eksempel:

"https://media.example.com/flux-3-result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Sist endret 9. september 2026

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Innholdsmoderering

API-nøkler

Velg en inndatamodus

Bruk referansebilder

Angi første og siste bilde

Angi varighet og størrelse

Oppgaveflyt

Autorisasjoner

Kropp

Svar

​Velg en inndatamodus

​Bruk referansebilder

​Angi første og siste bilde

​Angi varighet og størrelse

​Oppgaveflyt

Autorisasjoner

Kropp

Svar

Velg en inndatamodus

Bruk referansebilder

Angi første og siste bilde

Angi varighet og størrelse

Oppgaveflyt