Accéder au contenu

Ideogram Text to Image

Intégrer

Identifiant du modèle ideogram/v3
# 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/v3?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"

Cette requête: 0,06 $ 60 crédits API L'exécuter sur cette page

Obtenir une clé API
Ideogram · Image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•obligatoire
rendering_speed par défaut BALANCED

Paramètre de vitesse du rendu.

image_size par défaut square_hd

Résolution à utiliser pour l'image de sortie.

num_images par défaut 1

Nombre d’images à produire.

Avancé negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
par défaut

Spécifiez le contenu d'image indésirable ; les descriptions de l'invite principale sont prioritaires sur ces descriptions de l'invite négative.

image_urls
Déposez un fichier ou

Images de référence de style au format JPEG, PNG ou WebP. Leur taille combinée ne doit pas dépasser 10 MB.

style

Type de style utilisé pour la génération ; mutuellement exclusif avec style_codes.

Préréglage de style dont la sélection guide la génération de l'image.

Valeur de graine pour la génération de nombres aléatoires.

Codes de style d'image, fournis sous forme de chaînes hexadécimales de 8 caractères chacune ; omettez style_reference_images et style lors de l'utilisation de cette liste.

Palette de couleurs utilisée pendant la génération. Spécifiez soit un préréglage par son nom, soit des couleurs hexadécimales explicites via members, avec éventuellement des pondérations.

POST /run/ideogram/v3?wait=20 devis → 0,06 $
# 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/v3?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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Ideogram Text to Image

Génère des images à partir d’une `prompt` avec les vitesses de rendu TURBO, BALANCED ou QUALITY. Guidez l’apparence au moyen d’images de référence de style (`image_urls`), de `style_codes`, d’une `color_palette`, d’un `style` ou de l’une des 62 valeurs `style_preset`. Prend en charge jusqu’à 8 images par appel, une invite négative, l’expansion facultative de l’invite et des préréglages de taille.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlsfacultatif images
Typeurl[] · image
Images de référence de style au format JPEG, PNG ou WebP. Leur taille combinée ne doit pas dépasser 10 MB.
rendering_speedfacultatif
Typeenum
Par défautBALANCED
TURBOBALANCEDQUALITY
Paramètre de vitesse du rendu.
color_palettefacultatif
Typeobject
Palette de couleurs utilisée pendant la génération. Spécifiez soit un préréglage par son nom, soit des couleurs hexadécimales explicites via members, avec éventuellement des pondérations.
color_palette.membersfacultatif
Typeobject[]
Liste des membres de la palette définissant ses couleurs.
color_palette.members[].rgbobligatoire
Typeobject
Couleur du membre de la palette exprimée en RGB.
color_palette.members[].color_weightfacultatif
Typenumber | null
Par défaut0.5
0,05 – 1
Pondération attribuée à cette couleur dans la palette.
color_palette.namefacultatif
Typeenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Sélection du préréglage de la palette de couleurs.
style_codesfacultatif
Typestring[]
Codes de style d'image, fournis sous forme de chaînes hexadécimales de 8 caractères chacune ; omettez style_reference_images et style lors de l'utilisation de cette liste.
stylefacultatif
Typeenum
AUTOGENERALREALISTICDESIGN
Type de style utilisé pour la génération ; mutuellement exclusif avec style_codes.
expand_promptfacultatif
Typeboolean
Par défauttrue
Option d'utilisation de MagicPrompt pour la génération de la requête.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 8
Nombre d’images à produire.
seedfacultatif
Typeinteger | null
Valeur de graine pour la génération de nombres aléatoires.
style_presetfacultatif
Typeenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 de plusCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Préréglage de style dont la sélection guide la génération de l'image.
promptobligatoire
Typestring
image_sizefacultatif
Typeobject
Par défautsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Résolution à utiliser pour l'image de sortie.
negative_promptfacultatif
Typestring
Par défaut
Spécifiez le contenu d'image indésirable ; les descriptions de l'invite principale sont prioritaires sur ces descriptions de l'invite négative.
obligatoire Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu'à 10 MB ou le file_url d'un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "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
      }
    ],
    "seed": 42
  },
  "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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au modèle.
Champs de sortie
images
array of object {url, content_type, file_name, file_size}
seed
integerValeur de graine utilisée pour la génération de nombres aléatoires.

Plus de modèles : Texte vers image

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/ideogram/v3.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt