Rivya AI-dokumentation
Model-API-sider

Google Imagen4 API-integration

Brug Google Imagen4 via Rivya Public API v1 med model-id google-imagen4, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekstinput klarBillede
API-model-id

google-imagen4

Inputs

text

Files API

Ikke krævet for minimal anmodning

Basiscredits

8

Funktion

Billede

Fakturering

FIXED

Promptgrænse

5000 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

NøgleTypeKrævetStandardBeskrivelse
modelstringJagoogle-imagen4Brug API-model-id'et google-imagen4.
promptstringJa-Maksimalt 5000 tegn for denne model.
paramsobjectNej-Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_idstringNej-Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

NøgleTypeKrævetStandardIntervalValgmulighederBeskrivelse
aspect_ratioselectNej1:1-1:1, 16:9, 9:16, 3:4, 4:3Billedformat
negative_prompttextNej---Negativ prompt
seedtextNej---Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.

Minimal anmodning

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Valgfri ting, der skal undgås",
    "seed": "Valgfri seed-værdi"
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

{
  "id": "task_google_imagen4_example",
  "status": "queued",
  "model": "google-imagen4",
  "reserved_credits": 8,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.