Brug Ideogram Character via Rivya Public API v1 med model-id ideogram-character, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APIKlarstatusBillede

API-model-id

ideogram-character

Inputs

file

Files API

Krævet for referencetilstande

Basiscredits

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

Funktion

Billede

Fakturering

FIXED

Promptgrænse

5000 tegn

Anmodningskontrakt

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

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	ideogram-character	Brug API-model-id'et ideogram-character.
prompt	string	Ja	-	Maksimalt 5000 tegn for denne model.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
rendering_speed	select	Nej	BALANCED	-	TURBO, BALANCED, QUALITY	Afbalancerer hastighed, omkostning og detaljer. Turbo er hurtigst og billigst, Quality er mest detaljeret og dyrest, og Balanced er den mellemste standardmulighed.
style	select	Nej	AUTO	-	AUTO, REALISTIC, FICTION	Stil
expand_prompt	select	Nej	true	-	true, false	Ideograms indstilling til promptudvidelse. Når den slås til, hjælper den modellen med at udfolde din beskrivelse; slå den fra, når du vil have stram promptkontrol.
image_size	select	Nej	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Billedstørrelse
num_images	select	Nej	1	-	1, 2, 3, 4	Vælg 1–4 output. Den samlede pris er prisen pr. billede gange det valgte antal, rundet op til hele credits.
seed	number	Nej	-	-	-	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.
negative_prompt	text	Nej	-	-	-	Negativ prompt

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Karakterreferencebillede: Upload præcis 1 billedfil til dette projekt.

Maks. filer

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kind	Maks. størrelse	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal anmodning

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Valgfrit indhold, der skal undgås"
  }
}

Referencefilanmodning

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Valgfrit indhold, der skal undgås",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Oprettelsessvar

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

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.

Ideogram Character API-integration