runway_video

Technische specificaties van runway-video

Wat is runway-video?

runway-video is de platformidentificator van CometAPI voor toegang tot de videogeneratiecapaciteiten van Runway via een uniforme API. Op basis van de officiële API-documentatie van Runway biedt Runway meerdere videomodellen voor het genereren van clips uit tekstprompts of uit afbeeldingen, met taakgebaseerde eindpunten voor het starten van generaties en het later ophalen van resultaten.

In de praktijk wordt runway-video het best begrepen als een toegangspoort tot door Runway aangestuurde videocreation-workflows, in plaats van als één op zichzelf staande basismodelnaam. De huidige API-catalogus van Runway omvat verschillende videomodellen met uiteenlopende invoermodi en prijsniveaus, zoals gen4.5 voor tekst- of afbeelding-naar-video, gen4_turbo voor afbeelding-naar-video, en extra opties zoals gen4_aleph, veo3, veo3.1, veo3.1_fast en gen3a_turbo.

Dit maakt runway-video geschikt voor toepassingen zoals creatieve prototypering, het genereren van marketingcontent, productie van socialmediaclips, conceptvisualisatie en productervaringen die geautomatiseerde korte videogeneratie nodig hebben. Omdat de onderliggende Runway API asynchrone taken gebruikt, dienen integraties meestal eerst een generatieaanvraag in en pollen ze vervolgens of halen ze de taakoutput op zodra de verwerking is voltooid.

Belangrijkste functies van runway-video

• Tekst-naar-video-generatie: Runway ondersteunt het maken van video’s op basis van natuurlijke-taalprompts op ondersteunde modellen, waardoor ontwikkelaars direct clips uit beschrijvende tekst kunnen genereren.
• Afbeelding-naar-video-workflows: Verschillende videomodellen van Runway accepteren afbeeldingsinvoer, waardoor runway-video geschikt is voor het animeren van stilstaande beelden of het opzetten van referentiegestuurde videogeneratiepijplijnen.
• Meerdere onderliggende modelopties: De Runway API stelt meerdere videomodellen bloot met verschillende mogelijkheden en kostenprofielen, zodat ontwikkelaars kunnen optimaliseren voor kwaliteit, snelheid of budget.
• Asynchrone taakverwerking: Generatieverzoeken creëren taken in plaats van direct eindmedia terug te geven, wat goed past bij productiesystemen die wachtrijen, herhaalpogingen en statuscontroles nodig hebben.
• Tijdelijke assetuploads: Runway biedt uploadendpoints die runwayUri-referenties retourneren, waardoor het eenvoudiger wordt om afbeeldingen, video- of audiobestanden door te geven aan latere generatieverzoeken.
• Officiële SDK-ondersteuning: Runway levert Node.js- en Python-SDK's, die authenticatie, het opstellen van verzoeken en het ophalen van output kunnen vereenvoudigen.
• Versiegebonden API-integratie: Verzoeken vereisen een expliciete X-Runway-Version-header, wat ontwikkelaars helpt te bouwen tegen een bekende API-overeenkomst.
• Kredietgebaseerde prijsstelling: Runway factureert videogeneratie op basis van credits per seconde, met prijzen die variëren per het gekozen onderliggende model.

Toegang krijgen tot en integreren van runway-video

Stap 1: Meld u aan voor een API-sleutel

Maak een account aan en genereer een API-sleutel via uw CometAPI-dashboard om toegang te krijgen tot runway-video. Nadat u bent ingelogd, kopieert u uw API-sleutel en slaat u deze veilig op in een omgevingsvariabele of secrets manager voor productiegebruik.

Stap 2: Verzoeken naar de runway-video API verzenden

Gebruik uw API-sleutel om verzoeken te authenticeren naar het CometAPI-eindpunt voor runway-video. Geef uw prompt en eventuele ondersteunde invoerparameters door in de request-body en specificeer het model als 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."
  }'

Stap 3: Resultaten ophalen en verifiëren

Controleer na het indienen de API-respons op de gegenereerde output, taakidentifier of resultaatpayload die voor runway-video is teruggegeven. Als de generatie asynchroon verloopt, pollt u het relevante CometAPI-eindpunt totdat de verwerking is voltooid en valideert u vervolgens de geretourneerde video-URL, metadata en content voordat u deze in uw toepassing gebruikt.