Använd Ideogram V3 Remix via Rivyas publika API v1 med modell-ID ideogram-v3-remix, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIBeredskapBild

API-modell-ID

ideogram-v3-remix

Inmatningar

file

Files API

Krävs för referenslägen

Baskrediter

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

Förmåga

Bild

Fakturering

FIXED

Promptgräns

5000 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	ideogram-v3-remix	Använd API-modell-ID:t ideogram-v3-remix.
prompt	string	Ja	-	Högst 5000 tecken för den här modellen.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
rendering_speed	select	Nej	BALANCED	-	TURBO, BALANCED, QUALITY	Balanserar hastighet, kostnad och detalj. Turbo är snabbast och billigast, Quality är mest detaljerad och dyrast, och Balanced är standardvalet i mitten.
style	select	Nej	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN	Stil
expand_prompt	select	Nej	true	-	true, false	Ideograms promptutökningsväxel. Att slå på den hjälper modellen att fylla ut din beskrivning; att stänga av den är bättre när du vill ha strikt promptkontroll.
image_size	select	Nej	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Bildstorlek
num_images	select	Nej	1	-	1, 2, 3, 4	Välj 1–4 resultat. Totalsumman är priset per bild gånger valt antal, avrundat uppåt till hela krediter.
seed	number	Nej	-	-	-	Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte.
strength	number	Nej	0.8	min 0.01 / max 1	-	Styr hur starkt källbilden formar resultatet. Högre värden håller sig närmare originalstrukturen, medan lägre värden tillåter större avvikelser.
negative_prompt	text	Nej	-	-	-	Negativ prompt

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbild: Ladda upp exakt 1 bildfil för det här projektet.

Max filer

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kind	Max storlek	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal begäran

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "Valfria saker att undvika"
  }
}

Begäran med referensfil

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "Valfria saker att undvika",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

{
  "id": "task_ideogram_v3_remix_example",
  "status": "queued",
  "model": "ideogram-v3-remix",
  "reserved_credits": 7,
  "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
}

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.

Ideogram V3 Remix API-integration