runway_video2video

Specifiche tecniche di runway-video2video

Che cos'è runway-video2video?

runway-video2video è l'identificatore di modello di CometAPI per la funzionalità di generazione video-to-video di Runway, un workflow che prende una clip video esistente e la ri-renderizza in un nuovo stile visivo o in un'interpretazione guidata dal movimento utilizzando una guida basata su prompt. In pratica, viene usato per la stilizzazione, la trasformazione delle scene, lo sviluppo del look, VFX sperimentali e per trasformare riprese grezze in output più cinematografici o immaginativi.

La documentazione di supporto di Runway descrive Video to Video come un modo per cambiare lo stile dei video utilizzando un prompt testuale o un'immagine di input come primo frame. Le indicazioni di prodotto più recenti indicano inoltre che, sebbene Gen-3 Alpha e Turbo supportassero questo workflow, le raccomandazioni più nuove di Runway indirizzano gli utenti verso strumenti di nuova generazione per i casi d'uso video-to-video più aggiornati. Dal punto di vista dell'integrazione con CometAPI, tuttavia, runway-video2video è l'ID di modello della piattaforma da utilizzare per accedere a questa classe di funzionalità.

Funzionalità principali di runway-video2video

• Generazione guidata dal video: Parte da un video di input esistente invece di generare il movimento da zero, risultando utile per preservare struttura delle inquadrature, tempistica e composizione pur cambiando il risultato visivo.
• Trasformazione basata su prompt: Usa istruzioni in linguaggio naturale per controllare stile, atmosfera, reinterpretazione del soggetto o direzione degli effetti visivi dell'output.
• Trasferimento di stile e ri-renderizzazione creativa: Ideale per convertire riprese in trattamenti visivi animati, cinematografici, surreali o a marchio senza editing manuale frame-by-frame. Si tratta di un'inferenza basata sul workflow di stilizzazione video-to-video descritto da Runway.
• Workflow basati su riferimenti: La documentazione di Runway indica il supporto a una guida basata su immagini nei flussi di generazione video correlati, che aiuta a indirizzare la composizione o la coerenza estetica.
• Opzioni di output verticale e orizzontale: I workflow supportati includono formati di output standard orizzontali e verticali, utili per distribuzione su social, mobile e marketing.
• Efficienza per produzioni short-form: Il workflow di riferimento supporta clip brevi fino a 20 secondi, adatte a creatività pubblicitarie, shot concettuali, post social e pipeline di iterazione rapida.
• Accessibilità via API: Runway fornisce documentazione API e pattern di accesso ai modelli, abilitando l'integrazione programmatica in app creative, strumenti interni e pipeline multimediali automatizzate.

Come accedere e integrare runway-video2video

Passaggio 1: registrati e ottieni una chiave API

Per iniziare, registrati su CometAPI e genera la tua chiave API dalla dashboard. Una volta ottenuta, conservala in modo sicuro e usala per autenticare le richieste all'endpoint di CometAPI.

Passaggio 2: invia richieste all'API di runway-video2video

Usa il formato API ufficiale di Runway tramite CometAPI. L'endpoint è POST /runwayml/v1/video_to_video. Devi includere l'header X-Runway-Version.

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())

Passaggio 3: recupera e verifica i risultati

L'API restituisce un oggetto attività. Interroga l'endpoint di stato dell'attività per verificare quando la generazione del video è completa, quindi recupera l'URL del video di output. Per l'uso in produzione, aggiungi retry, polling dello stato e logging per garantire un'integrazione affidabile con runway-video2video.