Nutze Ideogram Character über Rivya Public API v1 mit Model-ID ideogram-character, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarBereitschaftBild

API-Modell-ID

ideogram-character

Eingaben

file

Files API

Für Referenzmodi erforderlich

Basis-Credits

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

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	ideogram-character	Verwende ideogram-character 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
rendering_speed	select	Nein	BALANCED	-	TURBO, BALANCED, QUALITY	Balanciert Geschwindigkeit, Kosten und Detail. Turbo ist am schnellsten und günstigsten, Qualität ist am detailliertesten und teuersten, und Ausgewogen ist der voreingestellte Mittelweg.
style	select	Nein	AUTO	-	AUTO, REALISTIC, FICTION	Stil
expand_prompt	select	Nein	true	-	true, false	Ideograms Prompt-Erweiterungsschalter. Einschalten hilft dem Modell, deine Beschreibung auszuarbeiten; Ausschalten ist besser, wenn du die Prompt-Kontrolle eng halten willst.
image_size	select	Nein	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Bildgröße
num_images	select	Nein	1	-	1, 2, 3, 4	Wähle 1–4 Ausgaben. Der Gesamtpreis ist der Bildpreis mal der gewählten Anzahl, auf ganze Credits aufgerundet.
seed	number	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.
negative_prompt	text	Nein	-	-	-	Negativer Prompt

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Charakter-Referenzbild: Lade für dieses Projekt genau 1 Bilddatei hoch.

Max. Dateien

Akzeptierte Dateitypen

image

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kind	Max. Größe	MIME-Typen
image	10 MB	image/jpeg, image/png, image/webp

Minimalrequest

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Optional zu vermeidender Inhalt"
  }
}

Request mit Referenzdatei

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Optional zu vermeidender Inhalt",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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_ideogram_character_example",
  "status": "queued",
  "model": "ideogram-character",
  "reserved_credits": 18,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

Einige Modi benötigen Referenz-Uploads über Files API.

Ideogram Character API-Integration