Použijte 4o Image přes Rivya Public API v1 s model id 4o-image, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.

Dostupné přes APITextový vstup připravenObrázek

ID API modelu

4o-image

Vstupy

text

Files API

Není vyžadováno pro minimální požadavek

Základní kredity

Schopnost

Obrázek

Fakturace

FIXED

Limit promptu

Není zdokumentovaný žádný limit promptu

Kontrakt požadavku

Model id posílejte na horní úrovni. Model-specific controls patří do params.

Klíč	Typ	Povinné	Výchozí	Popis
model	string	Ano	4o-image	Použijte API model id 4o-image.
prompt	string	Ano	-	Text promptu pro modely, které podporují textový vstup.
params	object	Ne	-	Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže.
client_request_id	string	Ne	-	Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

Klíč	Typ	Povinné	Výchozí	Rozsah	Možnosti	Popis
size	select	Ne	1:1	-	1:1, 3:2, 2:3	Poměr stran

Minimální požadavek

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

Odpověď vytvoření

Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.

{
  "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
}

Běžné chyby

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found