Passer au contenu

Ideogram Replace Background

Intégrer

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

# 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.

•requis

Prompt textuel, par exemple une ville cyberpunk composée de gratte-ciel éclairés au néon.

•requis image_url
Déposez un fichier, ou

URL pointant vers l'image nécessitant un remplacement d'arrière-plan.

rendering_speed par défaut BALANCED

Paramètre de vitesse du rendu.

num_images par défaut 1

Nombre d’images à produire.

Avancé images · style · 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 totale 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 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 via members, avec éventuellement des poids.

POST /run/ideogram/v3/replace-background?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/replace-background?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"
  }'

# 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 Replace Background

Remplace l’arrière-plan d’une image (`image_url`) selon un `prompt` textuel décrivant la nouvelle scène. Des références de style, `style_codes`, une `color_palette`, `style` et `style_preset` peuvent orienter le rendu. La vitesse de rendu est TURBO, BALANCED ou QUALITY, et 1 à 8 images peuvent être renvoyé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 totale 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 un préréglage par son nom ou des couleurs hexadécimales explicites via members, avec éventuellement des poids.
color_palette.membersfacultatif
Typeobject[]
Liste des membres de la palette définissant ses couleurs.
color_palette.members[].rgbrequis
Typeobject
Couleur du membre de 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 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
Interrupteur d'utilisation de MagicPrompt pour la génération de 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 guidant la génération de l'image.
promptrequis
Typestring
Prompt textuel, par exemple une ville cyberpunk composée de gratte-ciel éclairés au néon.
image_urlrequis image
Typeurl · image
URL pointant vers l'image nécessitant un remplacement d'arrière-plan.
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/replace-background",
  "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"
  },
  "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 au Go-mois) ou 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, vidéos et fichiers audio. output est le propre objet de résultat du 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 : Édition d’image

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