Passer 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

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis
rendering_speed par défaut BALANCED

Réglage de la vitesse de 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 ont priorité sur celles de l'invite négative.

image_urls
Déposez un fichier ou

Images de référence de style aux formats 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 guidant la génération de l’image.

Valeur de la 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 un préréglage par son nom ou des couleurs hexadécimales explicites par l'intermédiaire de members, avec des poids facultatifs.

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 au 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 avec des images de référence de style (`image_urls`), des `style_codes`, une `color_palette`, un `style` ou l’une des 62 valeurs de `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 aux formats JPEG, PNG ou WebP. Leur taille combinée ne doit pas dépasser 10 MB.
rendering_speedfacultatif
Typeenum
Par défautBALANCED
TURBOBALANCEDQUALITY
Réglage de la vitesse de rendu.
color_palettefacultatif
Typeobject
Palette de couleurs utilisée pendant la génération. Spécifiez un préréglage par son nom ou des couleurs hexadécimales explicites par l'intermédiaire de members, avec des poids facultatifs.
color_palette.membersfacultatif
Typeobject[]
Liste des membres de la palette définissant ses couleurs.
color_palette.members[].rgbrequis
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
Poids attribué à 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 la 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 autresCOLORING_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 guidant la génération de l’image.
promptrequis
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 ont priorité sur celles de l'invite négative.
requis 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 dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers 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 la 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 en Markdown se trouve à https://doitong.com/fr-CA/developers/models/ideogram/v3.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt