Rivya AI -dokumentaatio
Mallien API-sivut

Google Imagen4 API -integraatio

Käytä mallia Google Imagen4 Rivya Public API v1:n kautta malli-ID:llä google-imagen4; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTekstisyöte valmisKuva
API-malli-ID

google-imagen4

Syötteet

text

Files API

Ei vaadita minimipyynnössä

Peruskrediitit

8

Kyvykkyys

Kuva

Laskutus

FIXED

Prompt-raja

5000 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

AvainTyyppiPakollinenOletusKuvaus
modelstringKyllägoogle-imagen4Käytä google-imagen4-arvoa API-malli-ID:nä.
promptstringKyllä-Enintään 5000 merkkiä tälle mallille.
paramsobjectEi-Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_idstringEi-Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

AvainTyyppiPakollinenOletusAlueVaihtoehdotKuvaus
aspect_ratioselectEi1:1-1:1, 16:9, 9:16, 3:4, 4:3Kuvasuhde
negative_prompttextEi---Negatiivinen prompti
seedtextEi---Jätä tyhjäksi, jos haluat joka kerta uuden satunnaisen tuloksen. Saman kokonaisluvun käyttäminen uudelleen helpottaa aiemman tuloksen toistamista tai hienosäätöä. Tulos pysyy lähempänä vain silloin, kun kehote ja muut keskeiset asetukset ovat myös samankaltaisia, eikä se takaa täsmälleen samaa lopputulosta.

Minimipyyntö

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Valinnaiset vältettävät asiat",
    "seed": "Valinnainen seed-arvo"
  }
}

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

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

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.