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.
| Nyckel | Typ | Obligatoriskt | Standard | Beskrivning |
|---|---|---|---|---|
| model | string | Ja | 4o-image | Använd API-modell-ID:t 4o-image. |
| prompt | string | Ja | - | Prompttext för modeller som stöder textinmatning. |
| params | object | Nej | - | Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar. |
| client_request_id | string | Nej | - | Valfritt klient-ID för att spåra begäranden i ditt system. |
Modellparametrar
| Nyckel | Typ | Obligatoriskt | Standard | Intervall | Alternativ | Beskrivning |
|---|---|---|---|---|---|---|
| size | select | Nej | 1:1 | - | 1:1, 3:2, 2:3 | Bildfö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.