Tekniske specifikationer for runwayml-image-to-video
| Specifikation | Detaljer |
|---|---|
| Model-ID | runwayml-image-to-video |
| Udbyder | Runway |
| Primær kapabilitet | Genererer video ud fra et startbillede ved hjælp af en tekstprompt og billedbetinget bevægelsesgenerering. |
| API-opgavetype | Asynkron image-to-video-genereringsopgave startet via Runways image-to-video-endpoint. |
| Understøttede underliggende modeller i Runways API | Runways image-to-video-endpoint accepterer flere videomodeller, herunder gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast og veo3. |
| Påkrævede input | Et inputbillede plus modelspecifikke genereringsparametre; prompt-tekst bruges ofte til at beskrive ønsket bevægelse og scenens adfærd. |
| Godkendelse | Bearer-API-nøgle i Authorization-headeren. |
| Versionsheader | Runways API-reference kræver headeren X-Runway-Version med den dokumenterede værdi 2024-11-06 for image-to-video-endpointet. |
| Outputformat | Genereret videoressource returneres gennem opgavebaseret API-behandling. |
| Typisk billedhastighed | Runways dokumentation angiver 24 fps for Gen-3 Alpha image-to-video-output. |
| Almindelig outputopløsning | Runway dokumenterer 1280×768 for Gen-3 Alpha og både 1280×768 og 768×1280 for Gen-3 Alpha Turbo, afhængigt af orientering. |
| Vejledning for billedinput | Runway anbefaler at undgå referencebilleder mindre end 640×640 px eller større end 4K som billede-input. |
| Brugsmønster på CometAPI | Tilgås via CometAPI ved at bruge platformens modelidentifikator runwayml-image-to-video. |
Hvad er runwayml-image-to-video?
runwayml-image-to-video er CometAPIs modelidentifikator til at få adgang til Runways image-to-video-genereringsfunktion. I praksis tager denne modelkategori et stillbillede som visuelt udgangspunkt og omdanner det til en genereret video, typisk guidet af en tekstprompt, der beskriver bevægelse, kameraføring, atmosfære eller scenens udvikling.
Runway positionerer image-to-video som en del af sin bredere videogenereringsstack. Dets dokumentation for Gen-3 Alpha beskriver image-to-video som en måde at animere et leveret billede på, hvor prompting især fokuserer på bevægelse fremfor at genbeskrive alt, der allerede er synligt i billedet.
Fra et API-perspektiv udstiller Runway image-to-video-generering som et opgaveoprettelses-endpoint, hvilket betyder, at forespørgsler typisk starter en jobproces og derefter kræver polling eller hentningstrin for at få det endelige videoresultat, når behandlingen er færdig.
Hovedfunktioner i runwayml-image-to-video
- Billedbetinget videogenerering: Starter fra et stillbillede og genererer bevægelsesdrevet videooutput i stedet for at skabe video udelukkende fra tekst.
- Prompt-styret bevægelseskontrol: Fungerer bedst, når prompts beskriver bevægelse, kamerabevægelser og sceneskift for at animere det leverede billede sammenhængende.
- Asynkron opgave-arbejdsgang: Bruger en startgenereringsforespørgsel efterfulgt af resultathentning, hvilket passer til produktionssystemer, der køer og overvåger langvarige mediejobs.
- Flere underliggende modelvalg: Runways image-to-video-API-endpoint understøtter flere backend-videomodeller, hvilket giver udviklere fleksibilitet mht. kvalitet, hastighed og omkostningsprofiler.
- Produktionsorienteret API-godkendelse: Bruger standard Bearer-token-godkendelse og eksplicitte API-versionsheadere til kontrollerede integrationer.
- Understøttelse af portræt- og landskabsoutput: Runway dokumenterer outputstørrelser for både vandrette og lodrette genereringstilstande i de understøttede modelfamilier.
- Kompatibilitet med referencebillede-arbejdsgange: API'et er designet omkring billedreferencer, og Runway giver inputstørrelsesanbefalinger for at hjælpe med at opretholde genereringskvaliteten.
- Passer til en udvidelig kreativ pipeline: Runways bredere platform omfatter relaterede videogenereringsarbejdsgange såsom keyframes, udvidelse og andre genereringstilstande, hvilket gør image-to-video nyttigt som et trin i en større kreativ pipeline.
Sådan får du adgang til og integrerer runwayml-image-to-video
Trin 1: Tilmeld dig for at få en API-nøgle
Kom i gang ved at tilmelde dig på CometAPI og generere din API-nøgle fra dashboardet. Når du har en API-nøgle, skal du opbevare den sikkert og bruge den i Authorization-headeren for alle forespørgsler.
Trin 2: Send forespørgsler til runwayml-image-to-video-API'et
Brug Runways officielle API-format via CometAPI. Endpointet er POST /runwayml/v1/image_to_video. Medtag headeren X-Runway-Version.
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."
}'
Trin 3: Hent og verificér resultater
API'et returnerer et opgaveobjekt med et opgave-ID. Poll GET /runwayml/v1/tasks/{task_id} for at kontrollere genereringsstatus, og hent derefter output-URL'en fra svaret på den fuldførte opgave.