Passer au contenu

Ideogram V3 Edit

Intégrer

Identifiant du modèle ideogram/v3/edit
# 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/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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

Invite décrivant le remplissage de la région masquée de l’image.

•requis image_url
Déposez un fichier ou

Source de génération fournie comme URL d'image, la largeur et la hauteur devant correspondre exactement aux dimensions correspondantes du masque.

•requis mask_url
Déposez un fichier ou

Masque d'inpainting fourni par URL, la largeur et la hauteur devant correspondre exactement aux dimensions correspondantes de l'image d'entrée.

rendering_speed par défaut BALANCED

Réglage de la vitesse de rendu.

num_images par défaut 1

Nombre d’images à produire.

Avancé images · style_preset · seed · expand_prompt · style_codes · color_palette
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.

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/edit?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/edit?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 V3 Edit

Remplit une zone masquée d’une image selon un `prompt`. L’image (`image_url`) et le masque (`mask_url`) doivent avoir des dimensions identiques. Le style peut être orienté avec des images de référence, `style_codes`, une `color_palette` ou un `style_preset`. La vitesse de rendu peut être TURBO, BALANCED ou QUALITY, et 1 à 8 images peuvent être retournées.

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.
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
Invite décrivant le remplissage de la région masquée de l’image.
image_urlrequis image
Typeurl · image
Source de génération fournie comme URL d'image, la largeur et la hauteur devant correspondre exactement aux dimensions correspondantes du masque.
mask_urlrequis mask
Typeurl · image
Masque d'inpainting fourni par URL, la largeur et la hauteur devant correspondre exactement aux dimensions correspondantes de l'image d'entrée.
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/edit",
  "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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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 : Modification d’image

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/ideogram/v3/edit.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt