Tekniske spesifikasjoner for runwayml-image-to-video
| Spesifikasjon | Detaljer |
|---|---|
| Modell-ID | runwayml-image-to-video |
| Leverandør | Runway |
| Hovedfunksjon | Genererer video fra et startbilde ved hjelp av en prompttekst og bildebetinget bevegelsesgenerering. |
| API-oppgavetype | Asynkron bilde-til-video-genereringsoppgave som startes via Runways bilde-til-video-endepunkt. |
| Støttede underliggende modeller i Runway API | Runways bilde-til-video-endepunkt aksepterer flere videomodeller, inkludert gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast og veo3. |
| Obligatoriske inndata | Et inndatabilde pluss modellspesifikke genereringsparametere; prompttekst brukes ofte til å beskrive ønsket bevegelse og scenens oppførsel. |
| Autentisering | Bearer API-nøkkel i Authorization-headeren. |
| Versjonsheader | Runways API-dokumentasjon krever headeren X-Runway-Version, med den dokumenterte verdien 2024-11-06 for bilde-til-video-endepunktet. |
| Utdataformat | Generert videoressurs returneres gjennom oppgavebasert API-behandling. |
| Typisk bildefrekvens | Runways dokumentasjon oppgir 24 fps for Gen-3 Alpha bilde-til-video-utdata. |
| Vanlig utdataoppløsning | Runway dokumenterer 1280×768 for Gen-3 Alpha og både 1280×768 og 768×1280 for Gen-3 Alpha Turbo, avhengig av orientering. |
| Veiledning for bildeinndata | Runway anbefaler å unngå referansebilder mindre enn 640×640 px eller større enn 4K som bildeinndata. |
| Bruksmønster på CometAPI | Tilgås via CometAPI ved å bruke plattformens modellidentifikator runwayml-image-to-video. |
Hva er runwayml-image-to-video?
runwayml-image-to-video er CometAPIs modellidentifikator for å få tilgang til Runways bilde-til-video-genereringsfunksjon. I praksis tar denne kategorien av modell et stillbilde som visuelt utgangspunkt og transformerer det til en generert video, vanligvis styrt av en prompttekst som beskriver bevegelse, kameraføring, atmosfære eller sceneutvikling.
Runway plasserer bilde-til-video som en del av sin bredere videogenereringsstakk. Dokumentasjonen for Gen-3 Alpha beskriver bilde-til-video som en måte å animere et gitt bilde på, der promptene særlig fokuserer på bevegelse fremfor å beskrive på nytt alt som allerede er synlig i rammen.
Fra et API-perspektiv eksponerer Runway bilde-til-video-generering som et endepunkt for oppgaveopprettelse, noe som betyr at forespørsler typisk starter en jobb først og deretter krever polling eller hentetrinn for å få den endelige videoen når behandlingen er fullført.
Hovedfunksjoner i runwayml-image-to-video
- Bildebetinget videogenerering: Starter fra et stillbilde og genererer bevegelsesdrevet videoutdata i stedet for å skape video fra kun tekst.
- Promptstyrt bevegelseskontroll: Fungerer best når promptene beskriver bevegelse, kamerabevegelse og sceneendringer for å animere den gitte rammen på en sammenhengende måte.
- Asynkron oppgavearbeidsflyt: Bruker en start-genereringsforespørsel etterfulgt av resultatinnhenting, noe som passer produksjonssystemer som køer og overvåker langvarige mediejobber.
- Flere underliggende modellvalg: Runways bilde-til-video-API-endepunkt støtter flere backend-videomodeller og gir utviklere fleksibilitet når det gjelder kvalitet, hastighet og kostnadsprofiler.
- API-autentisering på produksjonsnivå: Bruker standard Bearer-token-autentisering og eksplisitte API-versjonsheadere for kontrollerte integrasjoner.
- Støtte for stående og liggende utdata: Runway dokumenterer utgangsstørrelser for både horisontale og vertikale genereringsmodi i støttede modelfamilier.
- Kompatibel med arbeidsflyt basert på referansebilder: API-et er designet rundt bildereferanser, og Runway gir anbefalinger for inndatastørrelser for å bidra til å opprettholde genereringskvaliteten.
- Passer i en utvidbar kreativ pipeline: Runways bredere plattform inkluderer relaterte videogenereringsarbeidsflyter som nøkkelbilder, utvidelse og andre genereringsmodi, noe som gjør bilde-til-video nyttig som ett trinn i en større kreativ pipeline.
Slik får du tilgang til og integrerer runwayml-image-to-video
Trinn 1: Registrer deg for en API-nøkkel
For å komme i gang registrerer du deg på CometAPI og genererer API-nøkkelen din fra dashbordet. Når du har en API-nøkkel, lagre den sikkert og bruk den i Authorization-headeren for alle forespørsler.
Trinn 2: Send forespørsler til runwayml-image-to-video-API-et
Bruk Runways offisielle API-format via CometAPI. Endepunktet er POST /runwayml/v1/image_to_video. Inkluder 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."
}'
Trinn 3: Hent og verifiser resultater
API-et returnerer et oppgaveobjekt med en oppgave-ID. Poll GET /runwayml/v1/tasks/{task_id} for å sjekke genereringsstatus, og hent deretter utdata-URL-en fra svaret for den fullførte oppgaven.