Technische specificaties van runwayml-image-to-video
| Specificatie | Details |
|---|---|
| Model-ID | runwayml-image-to-video |
| Provider | Runway |
| Primaire functie | Genereert video vanuit een startafbeelding met behulp van een tekstprompt en beeldgestuurde bewegingsgeneratie. |
| API-taaktype | Asynchrone image-to-video-generatietaak die wordt gestart via het image-to-video-endpoint van Runway. |
| Ondersteunde onderliggende modellen in de Runway API | Het image-to-video-endpoint van Runway accepteert meerdere videomodellen, waaronder gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast en veo3. |
| Vereiste invoer | Een invoerafbeelding plus modelspecifieke generatieparameters; prompttekst wordt vaak gebruikt om de gewenste beweging en het scènegedrag te beschrijven. |
| Authenticatie | Bearer-API-sleutel in de Authorization-header. |
| Versieheader | De API-referentie van Runway vereist de X-Runway-Version-header, met de gedocumenteerde waarde 2024-11-06 voor het image-to-video-endpoint. |
| Uitvoerformaat | Gegenereerde video-asset die wordt teruggegeven via taakgebaseerde API-verwerking. |
| Typische framesnelheid | De Runway-documentatie vermeldt 24 fps voor Gen-3 Alpha image-to-video-uitvoer. |
| Gebruikelijke uitvoerresolutie | Runway vermeldt 1280×768 voor Gen-3 Alpha en zowel 1280×768 als 768×1280 voor Gen-3 Alpha Turbo, afhankelijk van de oriëntatie. |
| Richtlijnen voor afbeeldingsinvoer | Runway raadt aan referentieafbeeldingen kleiner dan 640×640 px of groter dan 4K te vermijden. |
| Gebruikspatroon op CometAPI | Toegankelijk via CometAPI met de platformmodel-ID runwayml-image-to-video. |
Wat is runwayml-image-to-video?
runwayml-image-to-video is de modelidentifier van CometAPI voor toegang tot de image-to-video-generatiefunctie van Runway. In de praktijk neemt deze categorie modellen een stilstaand beeld als visueel startpunt en zet dit om in een gegenereerde video, doorgaans gestuurd door prompttekst die beweging, cameragedrag, sfeer of scène-evolutie beschrijft.
Runway positioneert image-to-video als onderdeel van zijn bredere stack voor videogeneratie. De documentatie voor Gen-3 Alpha beschrijft image-to-video als een manier om een aangeleverde afbeelding te animeren, waarbij de prompt vooral focust op beweging in plaats van het opnieuw beschrijven van alles wat al zichtbaar is in het frame.
Vanuit API-perspectief stelt Runway image-to-video-generatie beschikbaar als een taakcreatie-endpoint. Dit betekent dat verzoeken doorgaans eerst een job starten en vervolgens polling- of ophaalstappen vereisen om na voltooiing van de verwerking het uiteindelijke videoresultaat te verkrijgen.
Belangrijkste functies van runwayml-image-to-video
- Beeldgestuurde videogeneratie: Start vanuit een stilstaand beeld en genereert door beweging gedreven video-uitvoer in plaats van uitsluitend video uit tekst te maken.
- Prompt-gestuurde bewegingscontrole: Werkt het best wanneer prompts beweging, camerabeweging en scèneveranderingen beschrijven om het aangeleverde frame coherent te animeren.
- Asynchrone taakworkflow: Gebruikt een startgeneratieverzoek gevolgd door het ophalen van resultaten, passend bij productieomgevingen die wachtrijen en monitoring voor langlopende mediajobs gebruiken.
- Meerdere opties voor onderliggende modellen: Het image-to-video-API-endpoint van Runway ondersteunt verschillende backend-videomodellen, wat ontwikkelaars flexibiliteit biedt qua kwaliteit, snelheid en kosten.
- API-authenticatie in productiestijl: Maakt gebruik van standaard Bearer-tokenauthenticatie en expliciete API-versieheaders voor gecontroleerde integraties.
- Ondersteuning voor portret- en landschapsuitvoer: Runway documenteert uitvoergroottes voor zowel horizontale als verticale generatiemodi in ondersteunde modelfamilies.
- Compatibiliteit met workflow op basis van referentieafbeeldingen: De API is ingericht rond beeldreferenties en Runway geeft invoergrootteaanbevelingen om de generatiekwaliteit te behouden.
- Geschikt voor een uitbreidbare creatieve pipeline: Het bredere platform van Runway omvat verwante workflows voor videogeneratie zoals keyframes, uitbreiding en andere generatiemodi, waardoor image-to-video nuttig is als één fase in een grotere creatieve pipeline.
Hoe runwayml-image-to-video te benaderen en integreren
Stap 1: Registreer voor een API-sleutel
Begin door u aan te melden bij CometAPI en genereer uw API-sleutel via het dashboard. Nadat u een API-sleutel heeft, bewaar deze veilig en gebruik hem in de Authorization-header voor alle verzoeken.
Stap 2: Verstuur verzoeken naar de runwayml-image-to-video API
Gebruik het officiële API-formaat van Runway via CometAPI. Het endpoint is POST /runwayml/v1/image_to_video. Voeg de X-Runway-Version-header toe.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Stap 3: Resultaten ophalen en verifiëren
De API retourneert een taakobject met een taak-ID. Poll GET /runwayml/v1/tasks/{task_id} om de generatiestatus te controleren en haal vervolgens de output-URL op uit de response van de voltooide taak.