Accéder au contenu

Ideogram · v3 · Reframe

Intégrer

Identifiant du modèle ideogram/v3/reframe
# 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/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

# 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 image_url
Déposez un fichier ou

URL pointant vers l'image à recadrer.

rendering_speed par défaut BALANCED

Paramètre de vitesse du rendu.

image_size •obligatoire

Résolution de l'image produite par le recadrage.

num_images par défaut 1

Nombre d’images à produire.

Avancé images · style · style_preset · seed · style_codes · color_palette
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/reframe?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/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  }'

# 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 · v3 · Reframe

Adapte une image existante (`image_url`) à un `image_size` cible, comme les préréglages carré, portrait ou paysage, en générant du contenu pour remplir l'espace supplémentaire. Le style peut être guidé par des images de référence, `style_codes`, une `color_palette`, un `style` ou un `style_preset`. Prend en charge les vitesses TURBO, BALANCED ou QUALITY et 1 à 8 sorties.

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.
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.
image_urlobligatoire image
Typeurl · image
URL pointant vers l'image à recadrer.
image_sizeobligatoire
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Résolution de l'image produite par le recadrage.
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/reframe",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  },
  "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 : Édition d’image

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