Usa Wan 2.7 Video tramite Rivya Public API v1 con model id wan-2-7-video, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APITesto o URL pronti; le modalità di riferimento usano Files APIVideo

ID modello API

wan-2-7-video

Input

text, file

Files API

Richiesto per le modalità con riferimento

Crediti base

Capacità

Video

Fatturazione

FIXED

Limite prompt

5000 caratteri

Contratto della richiesta

Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.

Key	Tipo	Obbligatorio	Predefinito	Descrizione
model	string	Sì	wan-2-7-video	Usa wan-2-7-video come ID modello API.
prompt	string	Sì	-	Massimo 5000 caratteri per questo modello.
params	object	No	-	Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_id	string	No	-	ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

Key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni	Descrizione
resolution	select	No	720p	-	720p, 1080p	Risoluzione
duration	select	No	5	-	5, 10, 15	Le esecuzioni da testo e immagine possono usare 5, 10 o 15 secondi. Il video editing attualmente si ferma a 10 secondi e Rivya normalizza automaticamente selezioni più lunghe in quella modalità.
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Le esecuzioni text-to-video e video-editing usano questo valore direttamente. Image-to-video attualmente segue la geometria del frame caricato invece di esporre uno switch separato per il rapporto d'aspetto.
negative_prompt	text	No	-	-	-	Prompt negativo
prompt_extend	select	No	true	-	true, false	Controlla se il modello riscrive il prompt prima della generazione. Lascialo attivo per comodità, oppure disattivalo quando hai già un prompt molto preciso.
watermark	select	No	false	-	false, true	Watermark
audio_setting	select	No	auto	-	auto, origin	Controlla come viene gestito l'audio nel percorso video-edit. Auto lascia decidere al modello, mentre Keep original prova a preservare l'audio del video sorgente.
seed	number	No	-	min 0 / max 2147483647	-	Lascialo vuoto per ottenere ogni volta un nuovo risultato casuale. Riutilizzare lo stesso numero intero rende più semplice riprodurre o rifinire un risultato precedente. Il risultato resta più vicino solo quando anche il prompt e le altre impostazioni chiave rimangono simili, e non garantisce una corrispondenza 1:1.

Regola di upload

Carica prima i file di riferimento, poi inserisci l'URL restituito e il durationToken dentro params.referenceMediaItems.

Regola di riferimento

Media di riferimento: Carica fino a 2 asset. Usa fino a 2 immagini per image-to-video, oppure 1 video più 1 immagine opzionale per video editing.

File massimi

Tipi di file accettati

image, video

Duration token

I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.

kind	Dimensione massima	Tipi MIME
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

Richiesta minima

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Esclusioni o modalità di errore opzionali da evitare.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Richiesta con file di riferimento

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Esclusioni o modalità di errore opzionali da evitare.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Risposta di creazione

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Alcune modalità richiedono upload di riferimento tramite Files API.

Integrazione API di Wan 2.7 Video