runway_video2video

Technische specificaties van runway-video2video

Wat is runway-video2video?

runway-video2video is de modelidentifier van CometAPI voor de video-naar-video-generatiemogelijkheid van Runway, een workflow die een bestaande videoclip neemt en deze opnieuw rendert in een nieuwe visuele stijl of bewegingsgestuurde interpretatie met promptgebaseerde aanwijzingen. In de praktijk wordt dit gebruikt voor stilering, scènetransformatie, look development, experimentele VFX, en het omzetten van ruwe beelden in meer cinematografische of fantasierijke resultaten.

De helpdocumentatie van Runway beschrijft Video to Video als een manier om de stijl van video’s te veranderen met een tekstprompt of een invoerafbeelding als eerste frame. Recentere productrichtlijnen geven ook aan dat, hoewel Gen-3 Alpha en Turbo deze workflow ondersteunden, nieuwere aanbevelingen van Runway gebruikers voor de laatste video-naar-video-use-cases wijzen op tooling van de nieuwste generatie, namelijk Gen-4 Aleph. Vanuit een CometAPI-integratieperspectief is runway-video2video echter de platformmodel-ID die je gebruikt om toegang te krijgen tot deze klasse van mogelijkheden.

Belangrijkste functies van runway-video2video

• Video-geleide generatie: Begint met een bestaande video-invoer in plaats van beweging vanaf nul te genereren, waardoor het nuttig is om shotstructuur, timing en compositie te behouden terwijl het visuele resultaat verandert.
• Promptgebaseerde transformatie: Gebruikt instructies in natuurlijke taal om de uitvoerstijl, sfeer, subjectherinterpretatie of richting van het visuele effect te sturen.
• Stijloverdracht en creatief opnieuw renderen: Zeer geschikt om materiaal om te zetten in geanimeerde, cinematografische, surrealistische of branded visuele treatments zonder handmatige frame-voor-frame-bewerking. Dit is een afleiding op basis van de door Runway beschreven video-naar-video-stylingworkflow.
• Referentiegevoelige workflows: De documentatie van Runway geeft aan dat in aanverwante videogeneratiestromen beeldgestuurde begeleiding wordt ondersteund, wat helpt bij het sturen van compositie of esthetische consistentie.
• Portret- en landschapsuitvoeropties: Ondersteunde workflows omvatten standaard horizontale en verticale uitvoerformaten, wat nuttig is voor social, mobiel en marketinglevering.
• Efficiëntie voor shortform-producties: De betreffende workflow ondersteunt korte clips tot 20 seconden, wat past bij advertentiemateriaal, conceptshots, social posts en pijplijnen voor snelle iteratie.
• API-toegankelijkheid: Runway biedt API-documentatie en toegangspatronen voor modellen, waardoor programmatische integratie in creatieve apps, interne tools en geautomatiseerde mediapijplijnen mogelijk is.

Hoe krijg je toegang tot en integreer je runway-video2video

Stap 1: Meld je aan voor een API-sleutel

Om te beginnen, meld je je aan bij CometAPI en genereer je je API-sleutel vanuit het dashboard. Zodra je je sleutel hebt, sla je deze veilig op en gebruik je hem om aanvragen naar het CometAPI-eindpunt te verifiëren.

Stap 2: Verzend verzoeken naar de runway-video2video-API

Gebruik het officiële API-formaat van Runway via CometAPI. Het eindpunt is POST /runwayml/v1/video_to_video. Je moet de header X-Runway-Version opnemen.

curl https://api.cometapi.com/runwayml/v1/video_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "videoUri": "https://example.com/your-source-video.mp4",
    "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence with dramatic atmosphere and smooth motion.",
    "seed": 1,
    "ratio": "1280:720",
    "references": [],
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_to_video",
    headers={
        "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
        "Content-Type": "application/json",
        "X-Runway-Version": "2024-11-06",
    },
    json={
        "model": "gen4_aleph",
        "videoUri": "https://example.com/your-source-video.mp4",
        "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence.",
        "seed": 1,
        "ratio": "1280:720",
        "references": [],
        "contentModeration": {"publicFigureThreshold": "auto"},
    },
)
print(resp.json())

Stap 3: Resultaten ophalen en verifiëren

De API retourneert een taakobject. Poll het taakstatus-eindpunt om te controleren wanneer de videogeneratie is voltooid, en haal vervolgens de uitvoervideo-URL op. Voor productiegebruik voeg je herhalingspogingen, statuspolling en logging toe om een betrouwbare integratie met runway-video2video te waarborgen.