Een Flux 3-video maken

Maak een Flux 3-video op basis van tekst, referentieafbeeldingen of eerste en laatste frames. Sla de geretourneerde id op om de taak te pollen en de voltooide video te downloaden. POST /v1/videos gebruikt multipart/form-data. Verstuur besturingselementen als formuliervelden. Gebruik voor afbeeldingsinvoer URL’s van referentieafbeeldingen of openings- en sluitingsframes. Houd input_reference gescheiden van first_frame en last_frame.

Kies een invoermodus

Doel	Verplichte velden	Optionele velden
Tekst-naar-video	`model=flux-3`, `prompt`	`seconds`, `size`
HTTPS-afbeelding-naar-video	`model=flux-3`, `prompt`, één `input_reference`-URL	`seconds`, `size`
Geordende keyframes	`model=flux-3`, `prompt`, herhaalde `input_reference`-URL’s	`seconds`, `size`
Geüpload openingsframe	`model=flux-3`, `prompt`, één `first_frame`-bestand	`seconds`, `size`
Video met eerste en laatste frame	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Referentieafbeeldingen gebruiken

Het veld input_reference accepteert alleen openbaar toegankelijke HTTPS-URL’s van afbeeldingen. Verstuur het eenmaal voor één afbeelding, of herhaal het in keyframevolgorde voor meerdere afbeeldingen. Gebruik één URL per veld, met maximaal 10 URL’s in totaal. Beschrijf de beweging, het cameragedrag en de visuele details die de gegenereerde video van de referentieafbeelding moet behouden. De voorbeeldaanvragen boven aan deze pagina tonen invoer met één en met meerdere afbeeldingen. De volgende aanvraag gebruikt twee afbeeldingen in de volgorde waarin ze zijn verstuurd:

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'

De eerste en laatste frames instellen

Verstuur first_frame om de openingsafbeelding in te stellen. Voeg last_frame toe om ook de sluitingsafbeelding in te stellen en beschrijf de beweging tussen de twee frames in prompt. Laat voor alleen een openingsframe last_frame weg. Een sluitingsframe vereist zowel first_frame als last_frame. Elk veld accepteert één openbaar toegankelijke HTTPS-URL of één PNG- of JPEG-bestand. Verstuur elk veld eenmaal, met een URL of een bestand. Houd elk bestand maximaal 20 MiB groot (20 × 1024 × 1024 bytes). De framevoorbeelden boven aan deze pagina tonen URL-invoer en bestandsuploads, waarbij seconds en size expliciet zijn ingesteld.

Duur en grootte instellen

Stel seconds expliciet in op een geheel getal van 5 tot en met 20. Stel size in op een van deze exacte vooraf ingestelde waarden voor WxH:

Resolutieniveau	Grootte
`720p`	`1280x720`
`1080p`	`1920x1080`

De groottewaarde selecteert het uitvoerresolutieniveau. Voor tekst-naar-video kunnen gecodeerde afmetingen worden aangepast voor codecuitlijning. Voor afbeelding-naar-video kan de referentieafbeelding ook de uiteindelijke kadrering en beeldverhouding bepalen.

Taakstroom

De taak maken

Verstuur de multipart-formulieraanvraag en sla de geretourneerde id op.

De taak pollen

Roep een Flux 3-video op totdat status gelijk is aan completed of failed.

Het resultaat downloaden

Wanneer de taak completed is, roept u Flux 3-video-inhoud downloaden aan om het MP4-bestand op te slaan.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

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

standaard:flux-3

vereist

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

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

vereist

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.

Vereist bereik: 5 <= x <= 20

size

enum<string>

standaard: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.

Beschikbare opties:

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://

Respons

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

string

vereist

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

Voorbeeld:

"<task_id>"

object

string

vereist

Object type for the asynchronous video task.

Allowed value: "video"

model

string

vereist

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

vereist

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

Beschikbare opties:

queued,

in_progress,

completed,

failed

progress

integer

vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100

created_at

integer<int64>

vereist

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Voorbeeld:

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

Voorbeeld:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

Contentmoderatie

API-sleutels

Kies een invoermodus

Referentieafbeeldingen gebruiken

De eerste en laatste frames instellen

Duur en grootte instellen

Taakstroom

Autorisaties

Body

Respons

​Kies een invoermodus

​Referentieafbeeldingen gebruiken

​De eerste en laatste frames instellen

​Duur en grootte instellen

​Taakstroom

Autorisaties

Body

Respons

Kies een invoermodus

Referentieafbeeldingen gebruiken

De eerste en laatste frames instellen

Duur en grootte instellen

Taakstroom