Passer au contenu

Ideogram V2 Edit

Intégrer

Identifiant du modèle ideogram/v2/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/v2/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,08 $ 80 crédits API L’exécuter sur cette page

Obtenir une clé API
Ideogram Modification d’image #realism#typography

Complétion Ideogram V2 basée sur un masque, remplissant une zone masquée à partir d’une invite

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

Fournir la source de génération sous forme d’URL d’image, en veillant à ce que l’image source et le masque aient des dimensions identiques.

•requis mask_url
Déposez un fichier ou

Fournir un masque d’inpainting par URL, en veillant à ce que ses dimensions soient égales à celles de l’image d’entrée.

Avancé style · seed · expand_prompt
style par défaut auto

Style visuel de l’image de sortie.

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

POST /run/ideogram/v2/edit?wait=20 devis → 0,08 $
# 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/v2/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 V2 Edit

Modifie une image en remplissant une région masquée. Nécessite `image_url`, `mask_url` (de mêmes dimensions que l’image) et un `prompt` pour la zone remplie. `style` facultatif (auto, general, realistic, design, render_3D, anime), `expand_prompt` et `seed`.

Paramètres

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

NomType Par défautAutorisé Description
promptrequis
Typestring
Invite décrivant le remplissage de la région masquée de l’image.
image_urlrequis image
Typeurl · image
Fournir la source de génération sous forme d’URL d’image, en veillant à ce que l’image source et le masque aient des dimensions identiques.
mask_urlrequis mask
Typeurl · image
Fournir un masque d’inpainting par URL, en veillant à ce que ses dimensions soient égales à celles de l’image d’entrée.
seedfacultatif
Typeinteger | null
Valeur de la graine pour la génération de nombres aléatoires.
stylefacultatif
Typeenum
Par défautauto
autogeneralrealisticdesignrender_3Danime
Style visuel de l’image de sortie.
expand_promptfacultatif
Typeboolean
Par défauttrue
Contrôle si MagicPrompt développe l’invite.
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/v2/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": 80,
    "usd": "0.08",
    "charged": 80,
    "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/v2/edit.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt