Usa 4o Image tramite Rivya Public API v1 con model id 4o-image, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APIInput testuale prontoImmagine

ID modello API

4o-image

Input

text

Files API

Non richiesto per la richiesta minima

Crediti base

Capacità

Immagine

Fatturazione

FIXED

Limite prompt

Nessun limite prompt documentato

Contratto della richiesta

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

Key	Tipo	Obbligatorio	Predefinito	Descrizione
model	string	Sì	4o-image	Usa 4o-image come ID modello API.
prompt	string	Sì	-	Testo del prompt per i modelli che supportano input testuale.
params	object	No	-	Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_id	string	No	-	ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

Key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni	Descrizione
size	select	No	1:1	-	1:1, 3:2, 2:3	Rapporto d'aspetto

Richiesta minima

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

Risposta di creazione

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

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found