Nutze Google Imagen4 über Rivya Public API v1 mit Model-ID google-imagen4, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarTexteingabe bereitBild

API-Modell-ID

google-imagen4

Eingaben

text

Files API

Für den Minimalrequest nicht erforderlich

Basis-Credits

Fähigkeit

Bild

Abrechnung

FIXED

Prompt-Limit

5000 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

Key	Typ	Erforderlich	Standard	Beschreibung
model	string	Ja	google-imagen4	Verwende google-imagen4 als API-Modell-ID.
prompt	string	Ja	-	Maximal 5000 Zeichen für dieses Modell.
params	object	Nein	-	Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_id	string	Nein	-	Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

Key	Typ	Erforderlich	Standard	Bereich	Optionen	Beschreibung
aspect_ratio	select	Nein	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3	Seitenverhältnis
negative_prompt	text	Nein	-	-	-	Negativer Prompt
seed	text	Nein	-	-	-	Lass das Feld leer, um jedes Mal ein neues zufälliges Ergebnis zu erhalten. Wenn du dieselbe Ganzzahl erneut verwendest, lässt sich ein früheres Ergebnis leichter reproduzieren oder feinabstimmen. Es bleibt nur dann näher am Original, wenn Prompt und andere wichtige Einstellungen ebenfalls ähnlich bleiben, und es ist keine garantierte 1:1-Übereinstimmung.

Minimalrequest

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Optionale Dinge, die vermieden werden sollen",
    "seed": "Optionaler Seed-Wert"
  }
}

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

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

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found