Rivya AI-dokumentation
Modellsidor för API

4o Image API-integration

Använd 4o Image via Rivyas publika API v1 med modell-ID 4o-image, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APITextinmatning klarBild
API-modell-ID

4o-image

Inmatningar

text

Files API

Krävs inte för minimal begäran

Baskrediter

3

Förmåga

Bild

Fakturering

FIXED

Promptgräns

Ingen dokumenterad promptgräns

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

NyckelTypObligatorisktStandardBeskrivning
modelstringJa4o-imageAnvänd API-modell-ID:t 4o-image.
promptstringJa-Prompttext för modeller som stöder textinmatning.
paramsobjectNej-Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_idstringNej-Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

NyckelTypObligatorisktStandardIntervallAlternativBeskrivning
sizeselectNej1:1-1:1, 3:2, 2:3Bildförhållande

Minimal begäran

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

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.