Consulta ID modelli Rivya API, disponibilità, modalità supportate, tabelle parametri, limiti prompt, regole per media di riferimento e link ai dettagli dei modelli.

Questa pagina è il riferimento API a livello di modello per Rivya API v1.

La tabella sotto è generata dallo stesso catalogo modelli e serializer pubblico usati da /api/v1/models. Non è un conteggio fisso di modelli scritto a mano.

Come leggere questo riferimento

Usa l'id del modello come model in POST /api/v1/generations per modelli asincroni di immagini, video e audio.
Usa gli ID dei modelli chat in POST /api/v1/chat/completions.
Usa prompt al livello principale per il testo del prompt di generazione.
Usa message al livello principale per i turni Chat API.
Inserisci i campi asincroni specifici del modello dentro params.
Leggi api_input_status prima di costruire un'integrazione. available_text e available_url_input possono essere testati senza upload file; partial_requires_files significa che solo alcune modalità richiedono Files API; requires_files_api significa che devi caricare media di riferimento tramite Files API prima di chiamare il modello.
Per i modelli chat, leggi chat_capabilities per supporto non streaming, supporto streaming SSE, allegati immagine file_id, web search, thoughts e reasoning effort.
Le pagine dettaglio dei modelli offrono indicazioni ed esempi a livello prodotto.

Pattern di richiesta

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Per esempi JavaScript e Python, vedi creare una generazione.

Forma della richiesta Chat:

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Per esempi Chat, vedi Chat API.

Riferimento dinamico dei modelli

Usa questo riferimento con il debugger

Parti dal quickstart, conferma qui i campi del modello, poi esegui una richiesta mock o live autenticata nel debugger Developers.

API Quickstart Debugger online

Z-Image

z-imageDisponibile via APIInput testuale pronto

Immagine · Il modello text-to-image leggero di Alibaba. Generazione rapida di una singola immagine con 5 rapporti d'aspetto, ideale per bozze concettuali veloci e visual social a solo 1 credito.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

1000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Disponibile via APIParziale: richiede Files API

Immagine · Il modello immagine next-gen di Google con risoluzione 4K, 15 rapporti d'aspetto (incluso l'estremo 8:1), grounding Google Search e fino a 14 immagini di riferimento: il generatore immagini più flessibile su Rivya.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

image · 14 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 14 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	No	1K	-	1K, 2K, 4K
output_format	select	No	jpg	-	jpg, png
google_search	select	No	false	-	false, true

Nano Banana Pro

nano-banana-proDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine premium di Google con output 4K, 11 rapporti d'aspetto e fino a 8 immagini di riferimento. Ottimizzato per visual di marca e campagna ad alta fedeltà, con dettaglio e accuratezza colore superiori.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

10000 caratteri

Media di riferimento

image · 8 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 8 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	No	1K	-	1K, 2K, 4K
output_format	select	No	png	-	png, jpg

Nano Banana

nano-bananaDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine flessibile di Google per text-to-image e image-to-image con 11 rapporti d'aspetto, fino a 10 immagini di riferimento e output PNG/JPEG. Una scelta forte per ritratti, composizioni prodotto e visual landing-page più ampi.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 10 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 10 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
imageSize	select	No	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	No	png	-	png, jpeg

GPT Image 2

gpt-image-2Disponibile via APIParziale: richiede Files API

Immagine · Il modello GPT Image più recente di OpenAI su Rivya, con text-to-image, image-to-image, fino a 16 immagini di riferimento e livelli crediti chiari per 1K / 2K / 4K.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

image · 16 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

Regola di riferimento

Immagini di riferimento: Carica fino a 16 immagini di riferimento per attività image-to-image con GPT Image 2.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	No	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Disponibile via APIParziale: richiede Files API

Immagine · Il modello immagini di OpenAI con livelli qualità Medium/High e fino a 16 immagini di riferimento. Eccelle nel seguire istruzioni complesse e nel renderizzare scene coerenti con relazioni spaziali accurate.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

Media di riferimento

image · 16 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 16 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
quality	select	No	medium	-	medium, high
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageDisponibile via APIInput testuale pronto

Immagine · Il modello 4o Image di OpenAI è ora disponibile su Rivya come percorso dedicato da testo a immagine. Per ora la pagina resta volutamente essenziale: prompt più 3 rapporti d'aspetto supportati, a un prezzo fisso di 3 crediti per immagine.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
size	select	No	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteDisponibile via APIParziale: richiede Files API

Immagine · Modello immagine Seedream più leggero di ByteDance, con prezzo condiviso tra text-to-image e modifica immagini. Supporta 8 proporzioni, fino a 14 immagini di riferimento e al momento costa 6 crediti per esecuzione.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

3000 caratteri

Media di riferimento

image · 14 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 14 file immagine per i progetti basati su immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	No	basic	-	basic, high

Seedream 4.5

seedream-4-5Disponibile via APIParziale: richiede Files API

Immagine · Modello immagine di fascia alta di ByteDance con livelli qualità 2K/4K, 8 proporzioni e fino a 14 immagini di riferimento. È noto per color grading cinematografico e dettagli di texture ricchi nei visual fashion e lifestyle.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

3000 caratteri

Media di riferimento

image · 14 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 14 file immagine per i progetti basati su immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	No	basic	-	basic, high

Seedream 4.0

seedream-4-0Disponibile via APIParziale: richiede Files API

Immagine · Seedream 4.0 è un modello immagine ByteDance bilanciato su Rivya per generazione text-to-image, modifica con immagini di riferimento e controlli di output espliciti.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 10 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Regola di riferimento

Immagini di riferimento: Carica fino a 10 immagini per il percorso di modifica Seedream 4.0.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	No	1K	-	1K, 2K, 4K
max_images	number	No	1	min 1 / max 6 / step 1	-
seed	number	No	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	No	false	-	false, true

Seedream 3.0

seedream-3-0Disponibile via APIInput testuale pronto

Immagine · Seedream 3.0 torna su Rivya come modello immagine legacy autonomo. Al momento mantiene solo il percorso pubblico text-to-image e costa 5 crediti per esecuzione.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	No	2.5	min 1 / max 10 / step 0.1	-
seed	number	No	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagini di xAI con forte interpretazione creativa e 5 rapporti d'aspetto. Generazione a immagine singola focalizzata su espressione artistica e stili visivi non convenzionali.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	No	false	-	false, true

Flux 2 Pro

flux-2-proDisponibile via APIParziale: richiede Files API

Immagine · Il flagship da 32B parametri di Black Forest Labs. Supporta testo a immagine e immagine a immagine con fino a 8 immagini di riferimento, risoluzione 2K e rendering accurato del testo — progettato per scatti prodotto e visual di marca.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 8 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 8 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	No	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexDisponibile via APIParziale: richiede Files API

Immagine · Variante della famiglia Flux 2 focalizzata sull'editing. È specializzata in modifiche strutturali e trasferimento di stile con fino a 8 immagini di riferimento e risoluzione 2K — ideale per iterare su visual esistenti.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 8 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 8 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	No	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxDisponibile via APIParziale: richiede Files API

Immagine · Il modello Flux Kontext potenziato di Black Forest Labs per generazione guidata dal prompt e attività di editing immagini più esigenti. Rivya attualmente mantiene testo a immagine e immagine a immagine nello stesso progetto asincrono e li prezza a 8 crediti fissi per esecuzione secondo la policy attuale della piattaforma.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Testo filigrana opzionale"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti di editing immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	No	jpeg	-	jpeg, png
enableTranslation	select	No	true	-	true, false
promptUpsampling	select	No	false	-	false, true
safetyTolerance	number	No	2	min 0 / max 6	-
watermark	text	No	-	-	-

Flux Kontext Pro

flux-kontext-proDisponibile via APIParziale: richiede Files API

Immagine · Il progetto Flux Kontext a costo più contenuto di Black Forest Labs per text-to-image e modifica di una singola immagine. Rivya espone attualmente text-to-image e image-to-image nello stesso progetto immagine asincrono, con prezzo fisso di 4 crediti per entrambe le modalità secondo l'attuale politica prezzi della piattaforma.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Testo watermark facoltativo"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti di editing immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	No	jpeg	-	jpeg, png
enableTranslation	select	No	true	-	true, false
promptUpsampling	select	No	false	-	false, true
safetyTolerance	number	No	2	min 0 / max 6	-
watermark	text	No	-	-	-

Qwen2 Image

qwen2-imageDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine Qwen2 di Alibaba e attualmente integrato su Rivya come un progetto immagine a prezzo fisso. Copre in sicurezza text-to-image e image-to-image con il sottoinsieme condiviso di rapporti d'aspetto esposto da entrambe le documentazioni pubbliche, più output PNG/JPEG, riuso del seed e un semplice interruttore NSFW.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

800 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
image_size	select	No	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	No	png	-	png, jpeg
seed	number	No	-	min 0	-
nsfw_checker	select	No	false	-	false, true

Qwen Image

qwen-imageDisponibile via APIParziale: richiede Files API

Immagine · Modello immagine della famiglia Alibaba Qwen con preset HD (Square, Portrait, Landscape) e output PNG/JPEG. Forte con prompt in cinese e generazione visiva con sfumature culturali.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	No	png	-	png, jpeg

Midjourney

midjourneyDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine V7 di Midjourney per text-to-image e image-to-image, con modalità anime Niji, 3 livelli di velocità (Relaxed/Fast/Turbo), riferimenti di stile e coerenza guidata da Omni Reference. Resta il benchmark per arte cinematica, illustrazioni e moodboard.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

2000 caratteri

Media di riferimento

image · 4 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 4 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
speed	select	No	relaxed	-	relaxed, fast, turbo
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	No	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundDisponibile via APIRichiede Files API

Immagine · Modello di rimozione sfondo di Recraft su Rivya, pensato per isolare il soggetto da una singola immagine esistente. Usalo quando il passaggio successivo richiede un asset trasparente, un ritaglio pulito o un'immagine sorgente senza lo sfondo originale.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine sorgente: Carica esattamente 1 immagine. Bordi del soggetto più puliti di solito producono ritagli più puliti.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Recraft Crisp Upscale

recraft-crisp-upscaleDisponibile via APIRichiede Files API

Immagine · Modello leggero di upscaling immagini di Recraft su Rivya, pensato per aumentare nitidezza e chiarezza a basso costo su una singola immagine approvata. Usalo quando l'immagine scelta richiede solo una rifinitura economica prima dell'esportazione, non un ingrandimento pesante da consegna finale.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine sorgente: Carica esattamente 1 immagine. Questa opzione è pensata per una rapida rifinitura a basso costo.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Wan 2.7 Image Pro

wan-2-7-image-proDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine Wan 2.7 di fascia più alta di Alibaba, attualmente esposto su Rivya come slot immagine separato per text-to-image e image editing. Il pricing resta fisso a 12 crediti per esecuzione mantenendo esplicitamente la generazione a una sola immagine di output.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 9 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 9 file immagine per progetti di image editing.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	No	2K	-	1K, 2K
watermark	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageDisponibile via APIParziale: richiede Files API

Immagine · Il modello immagine Wan 2.7 standard di Alibaba è esposto su Rivya come slot immagine autonomo per text-to-image e image editing, e attualmente costa 5 crediti per esecuzione.

Guida API Pagina modello

Crediti base

Modalità

text-to-image, image-to-image

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 9 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 9 file immagine per progetti di image editing.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	No	2K	-	1K, 2K
watermark	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraDisponibile via APIInput testuale pronto

Immagine · Google Imagen4 Ultra è il livello Imagen text-to-image premium di Rivya. Attualmente è integrato come progetto a immagine singola con prezzo fisso di 12 crediti e controlli pubblici per prompt, prompt negativo, aspect ratio e seed.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Elementi facoltativi da evitare",
    "seed": "Valore seed facoltativo"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	text	No	-	-	-

Google Imagen4

google-imagen4Disponibile via APIInput testuale pronto

Immagine · Google Imagen4 è il livello Imagen text-to-image standard di Rivya. Attualmente è integrato come progetto a immagine singola con prezzo fisso di 8 crediti e controlli pubblici per prompt, prompt negativo, aspect ratio e seed.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Elementi facoltativi da evitare",
    "seed": "Valore seed facoltativo"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	text	No	-	-	-

Google Imagen4 Fast

google-imagen4-fastDisponibile via APIInput testuale pronto

Immagine · Google Imagen4 Fast è il livello Imagen text-to-image leggero di Rivya. Attualmente mantiene un progetto a immagine singola, usa un prezzo fisso di 4 crediti ed espone i controlli pubblici per prompt, prompt negativo, aspect ratio e seed senza aprire output multi-immagine.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "Elementi facoltativi da evitare",
    "seed": 0
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspect_ratio	select	No	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	No	-	-	-
seed	number	No	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleDisponibile via APIRichiede Files API

Immagine · Topaz Image Upscaler su Rivya è pensato per l'upscaling di immagini a livello di consegna, quando un'immagine statica è già approvata e deve fare un vero salto di dimensione. Usalo quando la composizione è definitiva e il problema rimasto riguarda la risoluzione di esportazione, la dimensione per la revisione o la preparazione alla stampa.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine sorgente: Carica 1 immagine approvata che vuoi preservare. Questa opzione serve per l'ingrandimento, non per la rielaborazione creativa.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
upscale_factor	select	No	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3Disponibile via APIInput testuale pronto

Immagine · Ideogram V3 e il modello text-to-image di Rivya per rendering del testo, layout poster e prompt immagine orientati al design. Il prezzo attuale e di 4 crediti per TURBO, 7 per BALANCED e 10 per QUALITY.

Guida API Pagina modello

Crediti base

Modalità

text-to-image

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Elementi opzionali da evitare"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
negative_prompt	text	No	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeDisponibile via APIRichiede Files API

Immagine · Ideogram V3 Reframe e attualmente integrato in Rivya come progetto di reframing a immagine singola con prezzi per velocità di rendering. Il prezzo attuale e di 4 crediti per TURBO, 7 per BALANCED e 10 per QUALITY.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento: Carica esattamente 1 file immagine per questo progetto.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixDisponibile via APIRichiede Files API

Immagine · Ideogram V3 Remix e attualmente integrato in Rivya come progetto di remix a immagine singola con prezzi per velocità di rendering. Il prezzo attuale e di 4 crediti per TURBO, 7 per BALANCED e 10 per QUALITY.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento: Carica esattamente 1 file immagine per questo progetto.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
strength	number	No	0.8	min 0.01 / max 1	-
negative_prompt	text	No	-	-	-

Ideogram Character

ideogram-characterDisponibile via APIRichiede Files API

Immagine · Opzione per coerenza del personaggio che trasforma una immagine personaggio approvata in nuove scene, outfit e formati. Usala quando mantenere l'identità conta più dell'editing immagine ampio e ti serve una sola immagine output alla volta.

Guida API Pagina modello

Crediti base

Modalità

image-to-image

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine riferimento personaggio: Carica 1 immagine chiara di riferimento del personaggio. Questa opzione ignora immagini extra e mantiene l'output a un solo risultato.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
rendering_speed	select	No	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	No	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	No	true	-	true, false
image_size	select	No	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	No	-	min 0	-
negative_prompt	text	No	-	-	-

Seedance 2.0

seedance-2Disponibile via APIInput testuale pronto

Video · Modello video Seedance 2.0 completo di ByteDance, con supporto esplicito per generazione solo da prompt, animazione guidata da frame e generazione con riferimenti multimodali. Rivya mantiene esplicita la divisione documentata dei ruoli, così gli input frame e i riferimenti multimodali restano mutuamente esclusivi invece di finire in un unico contenitore di upload ambiguo.

Guida API Pagina modello

Crediti base

175

Modalità

text-to-video, image-to-video, reference-to-video

Input API

Input testuale pronto

Input

text

Limite prompt

2500 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
seedance_scene	select	No	text	-	text, frames, reference
resolution	select	No	720p	-	480p, 720p
aspect_ratio	select	No	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	No	5	min 4 / max 15	-
generate_audio	select	No	true	-	true, false
return_last_frame	select	No	false	-	false, true
web_search	select	No	false	-	false, true
nsfw_checker	select	No	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastDisponibile via APIInput testuale pronto

Video · Modello video Seedance 2.0 più veloce di ByteDance, con instradamento completo delle scene per generazione solo da prompt, animazione guidata da frame e generazione video con riferimenti multimodali. Rivya mantiene esplicita la divisione documentata delle scene, così gli input di primo/ultimo frame non si confondono con i ruoli di immagini, video e audio di riferimento.

Guida API Pagina modello

Crediti base

140

Modalità

text-to-video, image-to-video, reference-to-video

Input API

Input testuale pronto

Input

text

Limite prompt

2500 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
seedance_scene	select	No	text	-	text, frames, reference
resolution	select	No	720p	-	480p, 720p
aspect_ratio	select	No	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	No	5	min 4 / max 15	-
generate_audio	select	No	true	-	true, false
return_last_frame	select	No	false	-	false, true
web_search	select	No	false	-	false, true
nsfw_checker	select	No	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proDisponibile via APIParziale: richiede Files API

Video · Modello video flagship di ByteDance per text-to-video e image-to-video con sincronizzazione audio-visiva nativa. Clip da 480p a 1080p, da 4 a 12s, 6 proporzioni, controllo lente dinamico/fisso, generazione audio opzionale e supporto lip-sync.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

2500 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 2 file immagine per i progetti basati su immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	8	-	4, 8, 12
generate_audio	select	No	false	-	false, true
aspectRatio	select	No	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	No	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proDisponibile via APIParziale: richiede Files API

Video · Il modello Seedance 1.0 Pro di ByteDance è esposto su Rivya come opzione 1.0 Pro standard sia per text-to-video sia per image-to-video. Mantiene la configurazione attuale della pagina allineata ai documenti pubblici V1 Pro, con controlli per risoluzione, durata, blocco camera, seed e controllo di sicurezza.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

10000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Regola di riferimento

Immagine di riferimento: Carica 1 file immagine per le esecuzioni image-to-video.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	No	false	-	false, true
seed	number	No	-1	min -1 / max 2147483647	-
enable_safety_checker	select	No	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastDisponibile via APIRichiede Files API

Video · Modello image-to-video veloce di ByteDance. Anima una singola immagine di riferimento in clip da 5s o 10s a 720p/1080p, ottimizzato per la rapidità quando ti serve un video veloce da un'immagine statica.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

10000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento: Carica 1 immagine sorgente per animarla in un video.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteDisponibile via APIParziale: richiede Files API

Video · Il modello Seedance 1.0 Lite di ByteDance è esposto su Rivya come opzione 1.0 più leggera sia per text-to-video sia per image-to-video. Segue il set pubblico di parametri V1 Lite e al momento usa una scala prezzi inferiore rispetto a Seedance 1.0 Pro.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

10000 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Regola di riferimento

Immagine di riferimento: Carica 1 immagine sorgente per image-to-video, oppure 2 immagini quando vuoi fornire anche un fotogramma finale opzionale.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	480p, 720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	No	false	-	false, true
seed	number	No	-1	min -1 / max 2147483647	-
enable_safety_checker	select	No	true	-	true, false

HappyHorse 1.0

happyhorse-1-0Disponibile via APIParziale: richiede Files API

Video · Un modello video AI flessibile su Rivya per text-to-video, motion da singola immagine, video con più immagini di riferimento e video editing da una sola pagina modello pubblica.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video, reference-to-video, video-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image, video · 10 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

Regola di riferimento

Media di riferimento: Usa fino a 9 immagini senza video, oppure 1 video con fino a 5 immagini di riferimento per video editing.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	1080p	-	720p, 1080p
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	No	5	min 3 / max 15	-
audio_setting	select	No	auto	-	auto, origin
seed	number	No	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoDisponibile via APIParziale: richiede Files API

Video · La linea video Wan più nuova di Alibaba con prezzo per risoluzione e durata. Rivya espone text-to-video, image-to-video e video editing in un solo slot modello, da 80 crediti per generazione.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video, video-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image, video · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "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
  }
}

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.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10, 15
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	No	-	-	-
prompt_extend	select	No	true	-	true, false
watermark	select	No	false	-	false, true
audio_setting	select	No	auto	-	auto, origin
seed	number	No	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6Disponibile via APIParziale: richiede Files API

Video · L'opzione Wan di Alibaba a tre modalità su Rivya: text-to-video, image-to-video e editing da video sorgente in un solo progetto. Supporta 720p/1080p, clip da 5-15 secondi e una immagine o un video sorgente alla volta.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video, video-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image, video · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

Regola di riferimento

Media di riferimento: Carica fino a 1 file immagine / video per progetti immagine / video.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoDisponibile via APIParziale: richiede Files API

Video · Wan 2.5 è ora esposto su Rivya come ingresso condiviso per text-to-video e image-to-video. I prezzi attuali sono `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100` e `1080p_10 = 200` crediti.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Esclusioni o modalità di errore opzionali da evitare.",
    "nsfw_checker": "false"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per la modalità image-to-video.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	720p, 1080p
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-
negative_prompt	text	No	-	-	-
nsfw_checker	select	No	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboDisponibile via APIParziale: richiede Files API

Video · Wan 2.2 A14B Turbo ora copre su Rivya text-to-video, image-to-video e un percorso video guidato da immagine e audio. I prezzi attuali sono `480p = 8` e `720p = 12` per esecuzioni da testo o immagine, più `480p = 16`, `580p = 20` e `720p = 24` quando il risultato è guidato da una immagine e una clip audio.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video, speech-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image, audio · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Esclusioni o modalità di errore opzionali da evitare.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Regola di riferimento

Media di riferimento: Carica fino a 2 asset. La modalità testo non ne richiede, image-to-video usa 1 immagine e il percorso guidato da immagine più audio usa 1 immagine più 1 clip audio.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	720p	-	480p, 580p, 720p
aspect_ratio	select	No	16:9	-	16:9, 9:16
enable_prompt_expansion	select	No	false	-	false, true
seed	number	No	-	min 0 / max 2147483647	-
acceleration	select	No	none	-	none, regular
num_frames	number	No	80	min 40 / max 120 / step 1	-
frames_per_second	number	No	16	min 4 / max 60 / step 1	-
negative_prompt	text	No	-	-	-
num_inference_steps	number	No	27	min 2 / max 40 / step 1	-
guidance_scale	number	No	3.5	min 1 / max 10 / step 0.1	-
shift	number	No	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	No	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceDisponibile via APIInput URL pronto

Video · Il modello video di Wan per sostituzione del personaggio su Rivya, pensato per cambiare chi appare in una clip esistente. Usa un URL pubblico del video sorgente, un URL pubblico dell'immagine sostitutiva e un livello di risoluzione quando il movimento è già corretto e deve cambiare solo il soggetto visibile.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Input URL pronto

Input

url

Limite prompt

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Questo modello accetta input URL pubblico tramite parametri del modello.

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
video_url	text	No	-	-	-
image_url	text	No	-	-	-
resolution	select	No	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3Disponibile via APIRichiede Files API

Video · Il modello image-to-video di MiniMax con livelli qualità Standard/Pro, risoluzione 768P/1080P e clip da 6s o 10s. Noto per movimenti più fluidi e transizioni naturali da immagini statiche.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
quality	select	No	standard	-	standard, pro
resolution	select	No	768P	-	768P, 1080P
duration	select	No	6	-	6, 10

Hailuo Pro

hailuo-proDisponibile via APIParziale: richiede Files API

Video · Il modello video Hailuo Pro storico di MiniMax è collegato qui come un modello fisso di livello Pro per text-to-video e image-to-video. La modalità immagine accetta 1 o 2 immagini di riferimento, con la seconda usata come ultimo frame, e ogni generazione costa attualmente 57 crediti.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

1500 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

Regola di riferimento

Immagini di riferimento: La modalità immagine accetta fino a 2 immagini, e la seconda immagine diventa l'ultimo frame.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
prompt_optimizer	select	No	false	-	false, true

Hailuo Standard

hailuo-standardDisponibile via APIParziale: richiede Files API

Video · Il modello video Hailuo Standard storico di MiniMax, unificato qui come un solo modello per text-to-video e image-to-video. La modalità immagine accetta 1 o 2 immagini di riferimento, con la seconda usata come ultimo frame, e i livelli di prezzo pubblici attualmente verificati vanno da 12 a 50 crediti.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

1500 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

Regola di riferimento

Immagini di riferimento: La modalità immagine accetta fino a 2 immagini, e la seconda immagine diventa l'ultimo frame.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	6	-	6, 10
resolution	select	No	512P	-	512P, 768P
prompt_optimizer	select	No	false	-	false, true

Kling 3.0

kling-3-0Disponibile via APIParziale: richiede Files API

Video · Modello video premium di Kuaishou per text-to-video e image-to-video, con livelli Standard (720P) / Pro (1080P), struttura single-shot o multi-shot, durata 3-15s, generazione audio opzionale e fino a 2 immagini di riferimento.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

2000 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

Regola di riferimento

Media di riferimento: Carica fino a 2 file immagine totali per progetti image-to-video.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
mode	select	No	pro	-	std, pro
multi_shots	select	No	false	-	false, true
duration	select	No	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	No	false	-	false, true
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlDisponibile via APIRichiede Files API

Video · Opzione Kling motion-control più nuova per guidare un soggetto da una immagine di riferimento più un video di movimento, con scelta esplicita della sorgente sfondo. Usala quando vuoi trasferimento movimento e controllo più forte su quale scena debba venire dal video o dall'immagine.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Richiede Files API

Input

file

Limite prompt

2500 caratteri

Media di riferimento

image, video · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento + video di movimento: Carica esattamente 1 immagine personaggio e 1 clip di movimento. Usa 3.0 quando ti servono sia controllo orientamento sia scelta della sorgente sfondo.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
mode	select	No	pro	-	std, pro
character_orientation	select	No	video	-	video, image
background_source	select	No	input_video	-	input_video, input_image

Kling 2.6

kling-2-6Disponibile via APIParziale: richiede Files API

Video · Modello video di Kuaishou con generazione audio opzionale, clip da 5s/10s e 3 rapporti d'aspetto. Forte nel movimento umano e nell'animazione espressiva dei personaggi, con fisica naturale.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

1000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
sound	select	No	false	-	false, true
aspect_ratio	select	No	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlDisponibile via APIRichiede Files API

Video · Progetto dedicato di trasferimento movimento per guidare un soggetto da una immagine di riferimento più un video di movimento. Usalo quando vuoi un passaggio Kling motion-control più economico e puoi fare a meno dei controlli scena aggiuntivi di Kling 3.0 motion-control.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Richiede Files API

Input

file

Limite prompt

2500 caratteri

Media di riferimento

image, video · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento + video di movimento: Carica esattamente 1 immagine personaggio e 1 clip di movimento. Entrambi dovrebbero mostrare chiaramente testa, spalle e busto.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
mode	select	No	720p	-	720p, 1080p
character_orientation	select	No	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proDisponibile via APIParziale: richiede Files API

Video · Il modello video Kling V2.5 Turbo Pro di Kuaishou, ora con supporto sia text-to-video sia image-to-video. Le prove pubbliche sui prezzi coprono chiaramente sia i livelli testo sia immagine a 5 e 10 secondi, quindi Rivya lo mappa direttamente a 42 / 84 crediti.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

2500 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descrivi cosa il video dovrebbe evitare",
    "cfg_scale": 0.5
  }
}

Regola di riferimento

Immagini di riferimento: Carica opzionalmente fino a 2 immagini per passare alla modalità image-to-video; la seconda immagine viene mappata al tail frame.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterDisponibile via APIParziale: richiede Files API

Video · Il modello video Kling V2.1 Master più vecchio di Kuaishou ora supporta sia text-to-video sia image-to-video su Rivya. Il prezzo attuale e di 160 crediti per 5 secondi e 320 crediti per 10 secondi.

Guida API Pagina modello

Crediti base

160

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descrivi cosa il video dovrebbe evitare",
    "cfg_scale": 0.5
  }
}

Regola di riferimento

Immagine di riferimento: Carica opzionalmente una immagine per passare alla modalità image-to-video; lasciala vuota per restare in modalità testo.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proDisponibile via APIRichiede Files API

Video · Il modello image-to-video Kling V2.1 Pro più vecchio di Kuaishou supporta un primo frame più una immagine tail frame opzionale. Il prezzo attuale e di 50 crediti per 5 secondi e 100 crediti per 10 secondi.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagini di riferimento: La modalità immagine accetta fino a 2 file immagine, e la seconda immagine viene mappata al tail frame.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardDisponibile via APIRichiede Files API

Video · Il modello image-to-video Kling V2.1 Standard più vecchio di Kuaishou. Il prezzo attuale e di 25 crediti per 5 secondi e 50 crediti per 10 secondi.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine di riferimento: La modalità immagine accetta fino a 1 file immagine come primo frame.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
negative_prompt	text	No	-	-	-
cfg_scale	number	No	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proDisponibile via APIRichiede Files API

Video · Kling AI Avatar Pro di Kuaishou e il modello talking-avatar di qualità più alta, che usa una immagine ritratto più una clip audio per generare un video avatar con lip-sync. Rivya attualmente lo prezza a 16 crediti fissi per generazione.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image, audio · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine ritratto e audio: Carica insieme una immagine ritratto e una clip audio.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Kling AI Avatar Standard

kling-ai-avatar-standardDisponibile via APIRichiede Files API

Video · Kling AI Avatar Standard di Kuaishou e il modello talking-avatar che usa una immagine ritratto più una clip audio per generare un video avatar con lip-sync. Rivya attualmente lo prezza a 8 crediti fissi per generazione.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image, audio · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine ritratto e audio: Carica insieme una immagine ritratto e una clip audio.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Infinitalk

infinitalkDisponibile via APIRichiede Files API

Video · Infinitalk e un modello talking-video basato su ritratto più audio. Il prezzo attuale e misurato in base a risoluzione e durata audio: 480p = 3 crediti al secondo e 720p = 12 crediti al secondo.

Guida API Pagina modello

Crediti base

Modalità

image-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

image, audio · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Immagine ritratto e audio: Carica insieme una immagine ritratto e una clip audio.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
resolution	select	No	480p	-	480p, 720p
seed	number	No	-	min 10000 / max 1000000	-

Runway

runwayDisponibile via APIParziale: richiede Files API

Video · Runway è un modello video autonomo che supporta sia text-to-video sia image-to-video. Le prove pubbliche sui prezzi confermano al momento solo 6 livelli di generazione, quindi Rivya lo mantiene nel set verificato: `720p_5 = 12`, `720p_10 = 30` e `1080p_5 = 30`.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

1800 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "Lascia vuoto per disattivare il watermark"
  }
}

Regola di riferimento

Immagine di riferimento: Carica opzionalmente una immagine per passare alla modalità image-to-video; lasciala vuota per restare in modalità testo.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
duration	select	No	5	-	5, 10
quality	select	No	720p	-	720p, 1080p
aspectRatio	select	No	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	No	-	-	-

Runway Aleph

runway-alephDisponibile via APIRichiede Files API

Video · Progetto di trasformazione da video sorgente per rielaborare una clip esistente in un nuovo risultato visivo. Usa Aleph quando il movimento arriva dal tuo filmato di input e la direzione creativa arriva dal prompt, con prezzo fisso da 90 crediti.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Richiede Files API

Input

file

Limite prompt

5000 caratteri

Media di riferimento

video, image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Media di input: Carica la clip sorgente che vuoi far trasformare ad Aleph. Aggiungi una sola immagine statica opzionale solo quando serve una guida extra su stile o soggetto.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	No	-	-	-
seed	number	No	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoDisponibile via APIRichiede Files API

Video · Progetto standalone di riscrittura source-video per spingere una clip esistente verso una nuova direzione visiva. Usalo quando il prompt deve trasformare il footage stesso, non solo rendere l'export più nitido.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

video · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Video di input: Carica una clip sorgente breve che vuoi trasformare. Questa opzione riscrive il footage invece di migliorarlo soltanto.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
watermark	text	No	-	-	-

Grok Imagine Video

grok-imagine-videoDisponibile via APIParziale: richiede Files API

Video · Il modello video di xAI con modalità creative Fun/Normal/Spicy e 5 rapporti d'aspetto. Preset di stile unici per diversi toni creativi — dal giocoso al cinematografico fino al più audace.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti immagine.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
mode	select	No	normal	-	fun, normal, spicy
duration	number	No	6	min 6 / max 30 / step 1	-
resolution	select	No	480p	-	480p, 720p
aspect_ratio	select	No	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proDisponibile via APIParziale: richiede Files API

Video · Livello premium di Sora 2 con modalità qualità Standard/High, clip da 10s/15s e rimozione watermark. Offre dettaglio, illuminazione e fedeltà del movimento migliorati per produzione video professionale.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

10000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per i progetti basati su immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
size	select	No	-	-	standard, high
n_frames	select	No	10	-	10, 15
aspect_ratio	select	No	landscape	-	landscape, portrait
remove_watermark	select	No	false	-	false, true
upload_method	select	No	s3	-	s3, oss

Sora 2

sora-2Disponibile via APIParziale: richiede Files API

Video · Modello video di OpenAI per text-to-video e image-to-video, con simulazione realistica del mondo, audio sincronizzato, clip da 10s/15s, output orizzontali/verticali e rimozione watermark opzionale.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

10000 caratteri

Media di riferimento

image · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per i progetti basati su immagini.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
n_frames	select	No	10	-	10, 15
aspect_ratio	select	No	landscape	-	landscape, portrait
remove_watermark	select	No	false	-	false, true
upload_method	select	No	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerDisponibile via APIInput URL pronto

Video · Modello di post-processing per rimozione watermark Sora su Rivya, pensato per link pubblici Sora già finalizzati. Usalo dopo che il video è già pronto, quando il compito restante è rimuovere il watermark e scegliere la consegna via S3 o OSS.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Input URL pronto

Input

url

Limite prompt

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Questo modello accetta input URL pubblico tramite parametri del modello.

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
video_url	text	Sì	-	-	-
upload_method	select	Sì	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleDisponibile via APIRichiede Files API

Video · Topaz Video Upscaler su Rivya è pensato per l'upscaling video a livello di consegna, quando una clip approvata ha bisogno solo di maggiore nitidezza in esportazione. Usalo quando inquadratura, movimento e timing sono già corretti e il problema rimasto è la risoluzione o la nitidezza del file finale.

Guida API Pagina modello

Crediti base

Modalità

video-to-video

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

video · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Video sorgente: Carica 1 clip sorgente che vuoi preservare. Questa opzione migliora la chiarezza di consegna invece di cambiare l'inquadratura.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
upscale_factor	select	No	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityDisponibile via APIParziale: richiede Files API

Video · La variante di Google Veo 3.1 orientata alla qualità per text-to-video premium e generazione guidata da immagini. Visual a fedeltà più alta, realismo del movimento più solido e audio di background incluso di default la rendono l'opzione Veo di fascia superiore su Rivya.

Guida API Pagina modello

Crediti base

150

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Testo filigrana opzionale",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 2 file immagine per il progetto guidato da immagini supportato.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Veo3.1 Fast

veo3-1-fastDisponibile via APIParziale: richiede Files API

Video · La variante veloce di Google Veo 3.1 con supporto a tre modalità: text-to-video, image-to-video e reference-to-video. Fino a 3 immagini di riferimento, audio nativo e controlli del rapporto d'aspetto sensibili alla modalità la rendono utile per clip cinematografiche rapide.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video, reference-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 3 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "Testo filigrana opzionale",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 3 file immagine per progetti guidati da immagini e riferimenti.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
generationType	select	No	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Veo3.1 Lite

veo3-1-liteDisponibile via APIParziale: richiede Files API

Video · La variante a costo più basso di Google Veo 3.1. Rivya attualmente espone solo il sottoinsieme stabile più piccolo: text-to-video e image-to-video a `10` crediti fissi per generazione.

Guida API Pagina modello

Crediti base

Modalità

text-to-video, image-to-video

Input API

Parziale: richiede Files API

Input

text, file

Limite prompt

5000 caratteri

Media di riferimento

image · 2 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Testo filigrana opzionale",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Regola di riferimento

Immagine di riferimento: Carica fino a 2 file immagine per il progetto guidato da immagini supportato.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità prompt o URL potrebbero essere già chiamabili. Le modalità con media di riferimento richiedono ancora il supporto upload di Files API. Files API

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
aspectRatio	select	No	16:9	-	16:9, 9:16, Auto
watermark	text	No	-	-	-
seeds	number	No	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	No	true	-	true, false

Suno Music

suno-musicDisponibile via APIInput testuale pronto

Audio · Suno Music è il modello text-to-music di Rivya per trasformare un breve brief in una prima bozza di canzone, con o senza voce. Mantiene il punto d'ingresso fisso da `12` crediti ed espone `Extend Music` come passaggio successivo dopo una traccia riuscita.

Guida API Pagina modello

Crediti base

Modalità

text-to-audio

Input API

Input testuale pronto

Input

text

Limite prompt

500 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
model	select	No	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	No	false	-	false, true

Suno Sounds

suno-soundsDisponibile via APIInput testuale pronto

Audio · Suno Sounds è il modello text-to-sound leggero di Rivya per loop d'ambiente, suoni di fondo e brevi sketch sonori. Mantiene il prezzo fisso documentato di `3` crediti per generazione e permette ai risultati riusciti di proseguire in `Vocal Separation`.

Guida API Pagina modello

Crediti base

Modalità

text-to-audio

Input API

Input testuale pronto

Input

text

Limite prompt

500 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
model	select	No	V5	-	V5, V5_5
soundLoop	select	No	false	-	false, true
soundTempo	number	No	-	min 1 / max 300 / step 1	-
soundKey	select	No	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsDisponibile via APIInput testuale pronto

Audio · Suno Lyrics è il modello di generazione testi di Rivya per trasformare un tema o un mood in parole da canzone, al costo fisso di `1` credito per richiesta.

Guida API Pagina modello

Crediti base

Modalità

text-to-audio

Input API

Input testuale pronto

Input

text

Limite prompt

200 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3Disponibile via APIInput testuale pronto

Audio · Il modello di dialogo multi-speaker di ElevenLabs su Rivya. È progettato per generazione vocale basata su ruoli, con assegnazione individuale delle voci, controlli di stabilità e ritmo pronto per dialoghi in podcast, interviste e scene con personaggi.

Guida API Pagina modello

Crediti base

Modalità

dialogue-to-audio

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
default_voice	select	No	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	No	0.5	-	0, 0.5, 1
language_code	text	No	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Disponibile via APIInput testuale pronto

Audio · Il modello text-to-speech veloce di ElevenLabs su Rivya. Con generazione vocale a bassa latenza e controlli regolabili per stabilità, somiglianza, stile e velocità, è pensato per bozze voiceover rapide e progetti TTS interattivi.

Guida API Pagina modello

Crediti base

Modalità

text-to-speech

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Contesto opzionale prima di questa riga",
    "next_text": "Contesto opzionale dopo questa riga",
    "language_code": "Codice locale opzionale, ad esempio it o en"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
voice	select	Sì	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	No	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	No	0.75	min 0 / max 1 / step 0.05	-
style	number	No	0	min 0 / max 1 / step 0.05	-
speed	number	No	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	No	false	-	false, true
previous_text	text	No	-	-	-
next_text	text	No	-	-	-
language_code	text	No	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Disponibile via APIInput testuale pronto

Audio · Il modello text-to-speech multilingue di ElevenLabs su Rivya, con supporto per circa 30 lingue e rilevamento automatico. È l'opzione più forte per localizzazione, consegna cross-lingua e voiceover multilingue più naturali.

Guida API Pagina modello

Crediti base

Modalità

text-to-speech

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
voice	select	Sì	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	No	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	No	0.75	min 0 / max 1 / step 0.05	-
style	number	No	0	min 0 / max 1 / step 0.05	-
speed	number	No	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	No	false	-	false, true
previous_text	text	No	-	-	-
next_text	text	No	-	-	-
language_code	text	No	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2Disponibile via APIInput testuale pronto

Audio · Il modello text-to-sound di ElevenLabs su Rivya per effetti brevi, transizioni e loop di ambiente. Genera clip audio da 0.5 a 22 secondi con influenza del prompt regolabile, modalità loop e 19 formati di output per progetti di editing, prodotto o gioco.

Guida API Pagina modello

Crediti base

Modalità

text-to-audio

Input API

Input testuale pronto

Input

text

Limite prompt

5000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parametri

key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni
loop	select	No	false	-	false, true
duration_seconds	number	No	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	No	0.3	min 0 / max 1 / step 0.05	-
output_format	select	No	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationDisponibile via APIRichiede Files API

Audio · Il modello ElevenLabs per pulizia audio e isolamento della voce su Rivya. Carica una registrazione per isolare la voce, rimuovere il rumore di fondo e ripulire l'audio parlato prima del montaggio o della pubblicazione.

Guida API Pagina modello

Crediti base

Modalità

audio-to-audio

Input API

Richiede Files API

Input

file

Limite prompt

Media di riferimento

audio · 1 file

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

Per questo modello non viene mostrato un esempio Public API eseguibile.

Regola di riferimento

Audio sorgente: Carica un file audio e Rivya isolerà e pulirà la traccia target.

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Le modalità basate su file richiedono /api/v1/files prima di poter essere mostrate come esempi API-ready completi. Files API

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.5

gpt-5-5-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat GPT avanzato di OpenAI su Rivya per ragionamento complesso, analisi image-aware, sintesi di ricerca e scrittura strutturata quando il brief richiede più spazio.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.4

gpt-5-4-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI di fascia più alta di OpenAI su Rivya, con gestione più forte degli input strutturati, controllo del ragionamento e progetti conversazionali orientati agli strumenti per analisi e scrittura più complesse.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.4 Codex

gpt-5.4-codex-chatDisponibile via APIInput testuale pronto

Chat · Il modello Codex di fascia più alta di OpenAI su Rivya, con capacità di coding più solide, ragionamento strutturato e collaborazione orientata agli strumenti per progetti di sviluppo impegnativi a scala repository.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.3 Codex

gpt-5-3-codex-chatDisponibile via APIInput testuale pronto

Chat · Il modello Codex più recente e capace di OpenAI su Rivya. Combina generazione di codice state-of-the-art con ragionamento agentico più profondo per i progetti di sviluppo più esigenti.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.2

gpt-5-2-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI flagship di OpenAI su Rivya, con ragionamento avanzato, supporto visivo fino a 6 immagini e finestra di contesto da 20K caratteri. È una forte opzione GPT generale per ricerca, pianificazione, scrittura e analisi image-aware.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.2 Codex

gpt-5-2-codex-chatDisponibile via APIInput testuale pronto

Chat · Il modello Codex più avanzato di OpenAI su Rivya, con ragionamento più forte per attività di ingegneria complesse. È ottimizzato per coding agentico a lungo orizzonte, decisioni architetturali e refactor più grandi in cui la semplice generazione di codice non basta.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5.1 Codex

gpt-5-1-codex-chatDisponibile via APIInput testuale pronto

Chat · Il modello Codex aggiornato di OpenAI su Rivya, con migliore accuratezza nel codice e ragionamento più forte per attività di coding agentico. Mantiene lo stesso progetto repo-aware a output lungo, migliorando refactor multi-file e modifiche al codice più sicure.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

GPT-5 Codex

gpt-5-codex-chatDisponibile via APIInput testuale pronto

Chat · Il modello GPT-5 Codex specializzato nel codice di OpenAI su Rivya per debugging, pianificazione dell'implementazione, refactor e problem solving tecnico con supporto visivo.

Guida API Pagina modello

Crediti base

Modalità

responses

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Gemini 3.1 Pro

gemini-3-1-pro-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI Gemini più recente e capace di Google su Rivya. Con ragionamento di fascia alta, visione e rispetto delle istruzioni, è l'opzione Gemini più forte per attività analitiche e creative impegnative.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Gemini 3 Pro

gemini-3-pro-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI Gemini a maggiore profondità di Google su Rivya. Con ragionamento più forte di Gemini 2.5 Pro e supporto visivo, è più adatto a sintesi di ricerca, scrittura tecnica e analisi multimodale più ponderata.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Gemini 3 Flash

gemini-3-flash-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI rapido di nuova generazione di Google su Rivya. Con costi token ancora più bassi di Gemini 2.5 Flash e ragionamento più forte, è pensato per chat multimodale ad alto volume, triage di screenshot e lavoro rapido da assistente.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Gemini 2.5 Pro

gemini-2-5-pro-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI Gemini più avanzato di Google su Rivya. Con ragionamento più forte di Flash, supporto visivo e contesto da 20K, è più adatto a sintesi di ricerca, analisi di documenti e scrittura strutturata a 2 crediti.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Gemini 2.5 Flash

gemini-2-5-flash-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat AI più rapido e conveniente di Google su Rivya. Con 1 credito per uso e supporto visivo fino a 6 immagini, è adatto a Q&A rapidi, prime sintesi, triage di screenshot e assistenza AI quotidiana.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text, file

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine devono usare valori file_id di Files API.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Opus 4.7

claude-opus-4-7-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude di punta di Anthropic su Rivya per ragionamento profondo, sintesi attenta, scrittura executive e lavoro testuale ad alto impatto.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Opus 4.6

claude-opus-4-6-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude AI di punta di Anthropic su Rivya. È progettato per ragionamento profondo, analisi complessa e scrittura di alta qualità in progetti esigenti e ad alto impatto.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Sonnet 4.6

claude-sonnet-4-6-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude AI bilanciato di Anthropic su Rivya. Mantiene ragionamento lungo e analisi attenta per progetti di contenuto, ricerca e coding senza passare subito a una spesa da Opus.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Opus 4.5

claude-opus-4-5-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude AI di punta di Anthropic su Rivya. Eccelle nel ragionamento profondo, nell'analisi complessa e nella scrittura di livello esperto, rendendolo una scelta premium per attività AI di importanza critica.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Sonnet 4.5

claude-sonnet-4-5-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude AI bilanciato di Anthropic su Rivya. È forte nella scrittura sfumata, nell'analisi attenta e nelle risposte attente alla sicurezza, rendendolo una solida opzione Claude per creazione di contenuti e ricerca.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Claude Haiku 4.5

claude-haiku-4-5-chatDisponibile via APIInput testuale pronto

Chat · Il modello chat Claude AI leggero di Anthropic su Rivya. È ottimizzato per velocità, efficienza dei costi e prestazioni quotidiane stabili in progetti ad alta frequenza dove vuoi il tono Claude senza una spesa premium.

Guida API Pagina modello

Crediti base

Modalità

chat-completion

Input API

Input testuale pronto

Input

text

Limite prompt

20000 caratteri

Media di riferimento

Richiesta

POST /api/v1/generations

Auth

Bearer API key

Idempotency-Key

Consigliato

Body

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Regola di riferimento

Risultato

La risposta di creazione restituisce un ID task pubblico. Interroga GET /api/v1/generations/{taskId} finché lo stato è succeeded o failed.

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API supporta turni non streaming e SSE streaming in Public API v1. Gli allegati immagine non sono supportati per questo modello Chat.

Parametri

Non è richiesto alcun parametro modello aggiuntivo.

Riferimento API dei modelli

Come leggere questo riferimento

Pattern di richiesta

Riferimento dinamico dei modelli

Usa questo riferimento con il debugger

Z-Image

Body

Parametri

Nano Banana 2

Body

Parametri

Nano Banana Pro

Body

Parametri

Nano Banana

Body

Parametri

GPT Image 2

Body

Parametri

GPT Image 1.5

Body

Parametri

4o Image

Body

Parametri

Seedream 5.0 Lite

Body

Parametri

Seedream 4.5

Body

Parametri

Seedream 4.0

Body

Parametri

Seedream 3.0

Body

Parametri

Grok Imagine

Body

Parametri

Flux 2 Pro

Body

Parametri

Flux 2 Flex

Body

Parametri

Flux Kontext Max

Body

Parametri

Flux Kontext Pro

Body

Parametri

Qwen2 Image

Body

Parametri

Qwen Image

Body

Parametri

Midjourney

Body

Parametri

Recraft Remove Background

Body

Parametri

Recraft Crisp Upscale

Body

Parametri

Wan 2.7 Image Pro

Body

Parametri

Wan 2.7 Image

Body

Parametri

Google Imagen4 Ultra

Body

Parametri

Google Imagen4

Body

Parametri