runway_video

Tekniske specifikationer for runway-video

Hvad er runway-video?

runway-video er CometAPI's platformidentifikator til at få adgang til Runways videogenereringsfunktioner via en samlet API. Baseret på Runways officielle API-dokumentation tilbyder Runway flere videomodeller til at generere klip ud fra tekstprompter eller fra billeder, med opgavebaserede endpoints til at starte genereringer og senere hente resultater.

I praksis er runway-video bedst forstået som en gateway til Runway-drevne videokreations-arbejdsgange frem for et enkelt, selvstændigt foundation-modellnavn. Runways nuværende API-katalog omfatter flere videomodeller med forskellige inputtilstande og prisniveauer, såsom gen4.5 til tekst- eller billede-til-video, gen4_turbo til billede-til-video samt yderligere muligheder som gen4_aleph, veo3, veo3.1, veo3.1_fast og gen3a_turbo.

Dette gør runway-video velegnet til anvendelser såsom kreativ prototyping, generering af marketingindhold, produktion af klip til sociale medier, konceptvisualisering og produktoplevelser, der har behov for automatiseret kortformsvideosyntese. Fordi den underliggende Runway-API bruger asynkrone jobs, indsender integrationer typisk først en genereringsanmodning og poller eller henter derefter opgavens output, når behandlingen er afsluttet.

Hovedfunktioner i runway-video

• Tekst-til-video-generering: Runway understøtter videokreation ud fra naturlig-sprog-prompter på understøttede modeller, hvilket gør det muligt for udviklere at generere klip direkte fra beskrivende tekst.
• Billede-til-video-arbejdsgange: Flere af Runways videomodeller accepterer billedinput, hvilket gør runway-video nyttig til at animere stillbilleder eller opbygge reference-drevne videogenereringspipelines.
• Flere underliggende modelmuligheder: Runway-API'en eksponerer flere videomodeller med forskellige kapaciteter og omkostningsprofiler, hvilket giver udviklere fleksibilitet til at optimere for kvalitet, hastighed eller budget.
• Asynkron opgavebehandling: Genereringsanmodninger opretter opgaver i stedet for straks at returnere endelige medier, hvilket er velegnet til produktionssystemer, der har behov for køhåndtering, gentagne forsøg og statuskontrol.
• Midlertidige uploads af aktiver: Runway stiller upload-endpoints til rådighed, der returnerer runwayUri-referencer, hvilket gør det nemmere at videregive billede-, video- eller lydaktiver til senere genereringsanmodninger.
• Officiel SDK-understøttelse: Runway tilbyder SDK'er til Node.js og Python, som kan forenkle godkendelse, opbygning af anmodninger og hentning af output.
• Versioneret API-integration: Anmodninger kræver en eksplicit X-Runway-Version-header, hvilket hjælper udviklere med at bygge mod en kendt API-kontrakt.
• Kreditbaseret prissætning: Runway afregner videogenerering i credits pr. sekund, hvor prisen varierer efter den valgte underliggende model.

Sådan får du adgang til og integrerer runway-video

Trin 1: Tilmeld dig for at få en API-nøgle

For at få adgang til runway-video skal du først oprette en konto og generere en API-nøgle via dit CometAPI-dashboard. Når du er logget ind, skal du kopiere din API-nøgle og gemme den sikkert i en miljøvariabel eller en secrets manager til produktionsbrug.

Trin 2: Send anmodninger til runway-video-API'en

Brug din API-nøgle til at godkende anmodninger til CometAPI-endpointet for runway-video. Angiv din prompt og eventuelle understøttede inputparametre i anmodningens body, og angiv modellen som runway-video.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

Trin 3: Hent og verificer resultater

Efter indsendelse skal du inspicere API-svaret for det genererede output, opgaveidentifikator eller resultatpayload, der returneres for runway-video. Hvis genereringen kører asynkront, skal du pollere det relevante CometAPI-endpoint, indtil behandlingen er afsluttet, og derefter validere den returnerede video-URL, metadata og indhold, før du bruger det i din applikation.