Naar hoofdinhoud gaan
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'
{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}
Gebruik deze endpoint om één bronafbeelding te animeren naar een Runway-video.

Voordat je deze aanroept

  • Verstuur de vereiste X-Runway-Version-header, bijvoorbeeld 2024-11-06
  • Gebruik model: gen3a_turbo
  • Geef een stabiele HTTPS-promptImage op
  • Begin met duration: 5 en een gangbare verhouding zoals 1280:720

Taakverloop

1

Dien het image-to-video-verzoek in

Maak de taak aan met een bronafbeelding en een optionele korte bewegingsprompt.
2

Sla de geretourneerde id op

Bewaar de taak-id om later te pollen.
3

Poll de taakstatus

Gebruik Taakdetails ophalen. Als de eerste poll task_not_exist retourneert, wacht dan een paar seconden en probeer het opnieuw.
Live validatie op 2026-03-13 bevestigde dat een minimaal gen3a_turbo-verzoek werd geaccepteerd en een id retourneerde. Na een korte vertraging retourneerden zowel de officiële taakdetails als de omgekeerde feed dezelfde wrapped queued status voor die taak.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

X-Runway-Version
string
vereist

Runway version header, for example 2024-11-06.

Body

application/json
promptImage
string
standaard:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
vereist

Source image URL.

model
string
standaard:gen3a_turbo
vereist

Runway image-to-video model ID. Choose a current model from the Models page.

seed
integer

Random seed for reproducible results. Range: 0–999999999.

promptText
string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark
boolean
standaard:false

Whether to add a watermark to the output video.

duration
integer
standaard:5

Video duration in seconds. Accepted values: 5 or 10.

ratio
enum<string>
standaard:1280:720

Aspect ratio of the output video.

Beschikbare opties:
1280:720,
720:1280,
1104:832,
832:1104,
960:960,
1584:672,
1280:768,
768:1280

Respons

200 - application/json

Task accepted.

id
string
vereist