Specifiche tecniche di runwayml-image-to-video
| Specifica | Dettagli |
|---|---|
| Model ID | runwayml-image-to-video |
| Provider | Runway |
| Funzionalità principale | Genera video a partire da un'immagine iniziale utilizzando un prompt testuale e una generazione del movimento condizionata dall'immagine. |
| Tipo di attività API | Attività asincrona di generazione immagine-a-video avviata tramite l'endpoint image-to-video di Runway. |
| Modelli sottostanti supportati nell'API di Runway | L'endpoint image-to-video di Runway accetta più modelli video, tra cui gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast e veo3. |
| Input richiesti | Un'immagine di input più parametri di generazione specifici del modello; il prompt testuale viene comunemente utilizzato per descrivere il movimento desiderato e il comportamento della scena. |
| Autenticazione | Chiave API Bearer nell'intestazione Authorization. |
| Intestazione di versionamento | La reference dell'API di Runway richiede l'intestazione X-Runway-Version, con il valore documentato 2024-11-06 per l'endpoint image-to-video. |
| Formato di output | Asset video generato restituito tramite elaborazione API basata su attività. |
| Frame rate tipico | La documentazione di Runway indica 24 fps per gli output immagine-a-video di Gen-3 Alpha. |
| Risoluzione di output comune | Runway documenta 1280×768 per Gen-3 Alpha e sia 1280×768 sia 768×1280 per Gen-3 Alpha Turbo, a seconda dell'orientamento. |
| Linee guida per l'immagine di input | Runway consiglia di evitare immagini di riferimento più piccole di 640×640 px o più grandi di 4K per gli input immagine. |
| Modello d'uso su CometAPI | Accessibile tramite CometAPI utilizzando l'identificatore di modello della piattaforma runwayml-image-to-video. |
Che cos'è runwayml-image-to-video?
runwayml-image-to-video è l'identificatore di modello di CometAPI per accedere alla funzionalità di generazione immagine-a-video di Runway. In pratica, questa categoria di modelli prende un'immagine statica come punto di partenza visivo e la trasforma in un video generato, tipicamente guidato da un prompt testuale che descrive movimento, comportamento della camera, atmosfera o evoluzione della scena.
Runway colloca l'immagine-a-video come parte del suo più ampio stack di generazione video. La documentazione per Gen-3 Alpha descrive l'immagine-a-video come un modo per animare un'immagine fornita, con i prompt focalizzati soprattutto sul movimento invece di ri-descrivere tutto ciò che è già visibile nell'inquadratura.
Dal punto di vista dell'API, Runway espone la generazione immagine-a-video come un endpoint di creazione di attività, il che significa che le richieste avviano tipicamente prima un job e poi richiedono passaggi di polling o recupero per ottenere il risultato video finale al termine dell'elaborazione.
Caratteristiche principali di runwayml-image-to-video
- Generazione video condizionata dall'immagine: parte da un'immagine statica e genera un output video guidato dal movimento, invece di creare video solo da testo.
- Controllo del movimento guidato dal prompt: funziona al meglio quando i prompt descrivono movimento, movimenti di camera e cambi di scena per animare in modo coerente l'inquadratura fornita.
- Flusso di lavoro asincrono basato su attività: utilizza una richiesta di avvio generazione seguita dal recupero del risultato, adatto a sistemi di produzione che mettono in coda e monitorano job multimediali di lunga durata.
- Molteplici opzioni di modello sottostante: l'endpoint API image-to-video di Runway supporta diversi modelli video backend, offrendo agli sviluppatori flessibilità in termini di qualità, velocità e profili di costo.
- Autenticazione API in stile produzione: utilizza l'autenticazione standard con token Bearer e intestazioni di versione dell'API esplicite per integrazioni controllate.
- Supporto per output verticali e orizzontali: Runway documenta dimensioni di output per entrambe le modalità di generazione orizzontale e verticale nelle famiglie di modelli supportate.
- Compatibilità con workflow basati su immagini di riferimento: l'API è progettata attorno a immagini di riferimento e Runway fornisce raccomandazioni sulle dimensioni di input per aiutare a mantenere la qualità di generazione.
- Integrazione in pipeline creative estensibili: la piattaforma più ampia di Runway include workflow correlati di generazione video come keyframe, espansione e altre modalità di generazione, rendendo l'immagine-a-video utile come una fase in una pipeline creativa più ampia.
Come accedere e integrare runwayml-image-to-video
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 nell'intestazione Authorization per tutte le richieste.
Passaggio 2: inviare le richieste all'API di runwayml-image-to-video
Utilizza il formato ufficiale dell'API di Runway tramite CometAPI. L'endpoint è POST /runwayml/v1/image_to_video. Includi l'intestazione X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Passaggio 3: recuperare e verificare i risultati
L'API restituisce un oggetto attività con un ID attività. Esegui polling su GET /runwayml/v1/tasks/{task_id} per verificare lo stato della generazione, quindi recupera l'URL di output dalla risposta dell'attività completata.