Référence API
Guides d’intégration
Erreurs
Tarification et facturation
Format officiel
Image vers vidéo
Utilisez CometAPI pour appeler Runway image_to_video et convertir l’URL d’une image fixe en sortie vidéo brute, avec la prise en charge de X-Runway-Version pour la compatibilité.
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"
}Utilisez cet endpoint pour animer une image source en une vidéo Runway.
Avant de l’appeler
- Envoyez l’en-tête requis
X-Runway-Version, par exemple2024-11-06 - Utilisez
model: gen3a_turbo - Fournissez un
promptImageHTTPS stable - Commencez avec
duration: 5et un ratio courant tel que1280:720
Flux de la tâche
Soumettre la requête image-to-video
Créez la tâche avec une image source et un court Prompt de mouvement facultatif.
Interroger le statut de la tâche
Utilisez Get Task Details. Si la première interrogation renvoie
task_not_exist, attendez quelques secondes puis réessayez.Une validation en conditions réelles le 2026-03-13 a confirmé qu’une requête minimale
gen3a_turbo était acceptée et renvoyait un id. Après un court délai, les task-details officiels ainsi que le feed inversé ont tous deux renvoyé le même statut en file d’attente encapsulé pour cette tâche.Autorisations
Bearer token authentication. Use your CometAPI key.
En-têtes
Runway version header, for example 2024-11-06.
Corps
application/json
promptImage
string
défaut:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
requis
Source image URL.
Runway image-to-video model ID. Choose a current model from the Models page.
Random seed for reproducible results. Range: 0–999999999.
Text prompt describing the desired motion or scene. Maximum 512 characters.
Whether to add a watermark to the output video.
Video duration in seconds. Accepted values: 5 or 10.
Aspect ratio of the output video.
Options disponibles:
1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280 Réponse
200 - application/json
Task accepted.
⌘I
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"
}