Opprett en Runway-oppgave for image-to-video

POST

runwayml

image_to_video

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Bruk dette endepunktet til å animere et kildebilde. Send CometAPI API-nøkkelen din med Bearer-autentisering og en JSON-forespørselstekst.

Velg en modell

Modell	Obligatoriske felt	Prompt for bevegelse
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	Beskriv bevegelsen i `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	Du kan eventuelt beskrive bevegelsen i `promptText`, med 1 til 1 000 UTF-16-kodeenheter.

For en forespørsel kun med tekst bruker du Opprett en Runway-oppgave for text-to-video.

Oppgi det første bildet

Sett promptImage til en tilgjengelig HTTPS-bilde-URL eller en Base64-bildedata-URI. Du kan også oppgi en matrise med ett element som inneholder uri og position: "first". Dette grensesnittet godtar én startramme; ikke legg til en oppføring for siste ramme. HTTPS-bilder må være direkte tilgjengelige uten omdirigeringer og ha gyldige innholdshoder for bilder. Kodede bildedata-URI-er kan være opptil 5 MB. Se Krav til Runway-medieinndata for bildeformater og dimensjoner.

Angi varighet og dimensjoner

Bruk en heltallsverdi for duration fra 2 til og med 10 sekunder. Det er påkrevd for gen4.5 og valgfritt for gen4_turbo. Sett ratio til 1280:720, 720:1280, 1104:832, 960:960, 832:1104 eller 1584:672. Dette er bredde- og høydeverdier atskilt med kolon. For et eksplisitt sampling-seed bruker du 1 til og med 4294967295. Utelatelse eller 0 velger et tilfeldig seed. Hvis du inkluderer contentModeration, må den tilhørende publicFigureThreshold settes til auto eller low; ellers utelater du objektet.

Velg et utdataformat

gen4.5 godtar outputFormat for MP4, ProRes, PNG-sekvenser og HDR- formatene som er oppført i forespørselsskjemaet. Utelat feltet for H.264 MP4. proresProfile gjelder bare for prores og hdr_prores; de tillatte verdiene avhenger av det valgte formatet. Utelat begge feltene med gen4_turbo.

Hent resultatet

Lagre den returnerte id og bruk Hent en Runway-oppgave. Når status er SUCCEEDED, leser du resultat-URL-ene i output.

Autorisasjoner

Authorization

string

header

påkrevd

Use your CometAPI API key.

Kropp

application/json

gen4.5
gen4_turbo

Request parameters for gen4.5.

model

enum<string>

påkrevd

Model ID for this request variant.

Tilgjengelige alternativer:

gen4.5

Allowed value: "gen4.5"

promptText

string

påkrevd

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000

promptImage

påkrevd

Image to use as the first frame. Supply a media URI or a one-item array with position set to first.

Maximum string length: 2048

Pattern: ^https://

ratio

enum<string>

påkrevd

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Tilgjengelige alternativer:

1280:720,

720:1280,

1104:832,

960:960,

832:1104,

1584:672

duration

integer

påkrevd

Requested video duration in whole seconds, from 2 through 10.

Nødvendig område: 2 <= x <= 10

seed

integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

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

contentModeration

object

Optional content moderation settings. Omit the object to use standard moderation.

Show child attributes

outputFormat

enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

Tilgjengelige alternativer:

mp4,

prores,

png_sequence,

hdr10,

hlg,

sdr_rec709_10bit,

hdr_pq_12bit_master,

hdr_prores,

hdr_png_sequence,

hdr_exr_sequence,

hdr_exr_acescg_sequence_1_3,

hdr_exr_acescg_sequence_2_0

proresProfile

enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

Tilgjengelige alternativer:

422,

4444,

422 Proxy,

422 LT,

422 HQ,

4444 XQ

Svar

Task submitted. Save its id to retrieve task status.

string

påkrevd

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Sist endret 18. september 2026

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Innholdsmoderering

API-nøkler

Opprett en Runway-oppgave for image-to-video

Velg en modell

Oppgi det første bildet

Angi varighet og dimensjoner

Velg et utdataformat

Hent resultatet

Autorisasjoner

Kropp

Svar

​Velg en modell

​Oppgi det første bildet

​Angi varighet og dimensjoner

​Velg et utdataformat

​Hent resultatet

Autorisasjoner

Kropp

Svar

Velg en modell

Oppgi det første bildet

Angi varighet og dimensjoner

Velg et utdataformat

Hent resultatet