runway_video

Specifiche tecniche di runway-video

Che cos’è runway-video?

runway-video è l’identificatore di piattaforma di CometAPI per accedere alle capacità di generazione video di Runway tramite un’API unificata. In base alla documentazione ufficiale dell’API di Runway, Runway offre più modelli video per generare clip da prompt testuali o da immagini, con endpoint basati su task per avviare le generazioni e recuperare i risultati in un secondo momento.

In pratica, runway-video va inteso come un gateway ai flussi di creazione video alimentati da Runway, più che come il nome di un singolo modello foundation standalone. Il catalogo attuale delle API di Runway include diversi modelli video con modalità di input e fasce di prezzo differenti, come gen4.5 per da testo/immagine a video, gen4_turbo per da immagine a video, e ulteriori opzioni come gen4_aleph, veo3, veo3.1, veo3.1_fast e gen3a_turbo.

Questo rende runway-video adatto a casi d’uso come prototipazione creativa, generazione di contenuti marketing, produzione di clip per social media, visualizzazione di concept e esperienze di prodotto che necessitano di sintesi video in formato breve automatizzata. Poiché l’API Runway sottostante utilizza job asincroni, le integrazioni in genere inviano prima una richiesta di generazione e poi eseguono il polling o recuperano l’output del task una volta terminata l’elaborazione.

Caratteristiche principali di runway-video

• Generazione da testo a video: Runway supporta la creazione di video a partire da prompt in linguaggio naturale sui modelli supportati, consentendo agli sviluppatori di generare clip direttamente da testo descrittivo.
• Flussi da immagine a video: Diversi modelli video di Runway accettano input di immagini, rendendo runway-video utile per animare immagini statiche o creare pipeline di generazione video guidate da riferimenti.
• Più opzioni di modelli sottostanti: L’API di Runway espone vari modelli video con capacità e costi differenti, offrendo flessibilità per ottimizzare qualità, velocità o budget.
• Elaborazione asincrona dei task: Le richieste di generazione creano task invece di restituire subito il media finale, soluzione adatta a sistemi in produzione che richiedono accodamento, retry e controlli di stato.
• Caricamenti temporanei di asset: Runway fornisce endpoint di upload che restituiscono riferimenti runwayUri, facilitando il passaggio di immagini, video o audio a richieste di generazione successive.
• Supporto SDK ufficiale: Runway offre SDK per Node.js e Python, che possono semplificare autenticazione, costruzione delle richieste e recupero dell’output.
• Integrazione API versionata: Le richieste richiedono un’intestazione X-Runway-Version esplicita, aiutando gli sviluppatori a costruire su un contratto API noto.
• Prezzi basati su crediti: Runway fattura la generazione video in crediti per secondo, con prezzi variabili in base al modello selezionato.

Come accedere e integrare runway-video

Passaggio 1: Registrati e ottieni una chiave API

Per accedere a runway-video, crea un account e genera una chiave API dal dashboard di CometAPI. Dopo l’accesso, copia la tua chiave API e conservala in modo sicuro in una variabile d’ambiente o in un gestore di segreti per l’uso in produzione.

Passaggio 2: Invia richieste all’API runway-video

Usa la tua chiave API per autenticare le richieste verso l’endpoint CometAPI per runway-video. Invia il prompt e gli eventuali parametri di input supportati nel body della richiesta e specifica il modello come 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."
  }'

Passaggio 3: Recupera e verifica i risultati

Dopo l’invio, esamina la risposta dell’API per l’output generato, l’identificatore del task o il payload di risultato restituito per runway-video. Se la generazione è asincrona, esegui il polling dell’endpoint CometAPI pertinente fino al completamento dell’elaborazione, quindi valida l’URL del video restituito, i metadati e il contenuto prima di utilizzarlo nella tua applicazione.