Op den Inhalt sprangen

Ideogram V4.0 Text to Image

Integréieren

Modell-ID ideogram/v4
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dateie wéi am Beispill: 0,015 $ 15 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Ideogram Text zu Bild #realism#typography#stylized

Ideogram V4 Text-zu-Bild mat auswielbarer Prompt-Ausbreedung, Geschwindegkeet a Beschleunegung, bis zu 4 Biller

Ideogram · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Prompt, deen d'Bild-Generatioun steiert.

image_size Standard square_hd

Opléisung fir dat generéiert Bild.

rendering_speed Standard BALANCED

Astellung vun der Rendergeschwindegkeet; méi séier Optioune féiere manner Denoising-Schrëtt aus.

num_images Standard 1

Unzuel vun de Biller, déi erstallt ginn.

Erweidert expansion_model · acceleration · output_format · seed · enable_safety_checker
expansion_model Standard Medium

Wielt de Prompt-Erweiderungsmodell: 'Large' liwwert iwwer Ideogram's Magic Prompt déi héchst Qualitéit, wärend 'Medium' d'Geschwindegkeet prioritär behandelt. Wielt 'None', fir de Prompt net ze erweideren.

acceleration Standard none

Beschleunegungsastellung fir d'Generéiere vu Biller.

output_format Standard jpeg

Dateiformat vum resultéierende Bild.

Seed fir d'Generatioun, zoufälleg ausgewielt, ausser Dir gitt e Wäert un.

POST /run/ideogram/v4?wait=20 Präis → 0,015 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Ideogram V4.0 Text to Image

Generéiert Biller aus engem `prompt`. `expansion_model` kann None, Medium oder Large sinn, an `rendering_speed` TURBO, BALANCED oder QUALITY, mat enger zousätzlecher `acceleration`-Astellung vun none bis high. Gëtt 1 bis 4 Biller als JPEG oder PNG a Gréisste-Presets zréck. Dëst ass déi komplettst V4 Text-zu-Bild-Optioun.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Prompt, deen d'Bild-Generatioun steiert.
expansion_modeloptional
Typenum
StandardMedium
NoneMediumLarge
Wielt de Prompt-Erweiderungsmodell: 'Large' liwwert iwwer Ideogram's Magic Prompt déi héchst Qualitéit, wärend 'Medium' d'Geschwindegkeet prioritär behandelt. Wielt 'None', fir de Prompt net ze erweideren.
image_sizeoptional
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Opléisung fir dat generéiert Bild.
rendering_speedoptional
Typenum
StandardBALANCED
TURBOBALANCEDQUALITY
Astellung vun der Rendergeschwindegkeet; méi séier Optioune féiere manner Denoising-Schrëtt aus.
accelerationoptional
Typenum
Standardnone
nonelowregularhigh
Beschleunegungsastellung fir d'Generéiere vu Biller.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Unzuel vun de Biller, déi erstallt ginn.
seedoptional
Typinteger | null
Seed fir d'Generatioun, zoufälleg ausgewielt, ausser Dir gitt e Wäert un.
enable_safety_checkeroptional
Typboolean
Standardtrue
Sécherheetskontrollschalter, deem seng ausgeschalt Astellung d'Autorisatioun vum Kont erfuerdert. Ouni dës Autorisatioun gëtt all Ufro onofhängeg vun der Astellung kontrolléiert; true aktivéiert d'Kontroll.
output_formatoptional
Typenum
Standardjpeg
jpegpng
Dateiformat vum resultéierende Bild.
obligatoresch Kanoneschen Numm, och akzeptéiert

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v4",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 15,
    "usd": "0.015",
    "charged": 15,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, content_type, file_name, file_size, width, height}Biller, déi vum Modell erstallt goufen.
timings
object
seed
integerSeed fir d'Bild-Generatioun, inklusiv dem zoufälleg gewielte Wäert, wann am Input kee Seed uginn ass; soss gëtt de geliwwerte Wäert widderholl.
has_nsfw_concepts
array of booleanGëtt un, ob NSFW-Konzepter an de generéierte Biller optrieden.
prompt
stringPrompt, deen während der Bild-Generatioun benotzt gëtt.

Méi Modeller: Text zu Bild

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/ideogram/v4.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt