Ir al contenido

Ideogram V3 Edit

Integrar

ID del modelo 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitud: $0.06 60 créditos de API · ≈ ₽6.33 Ejecutar en esta página

Obtener clave de API
Ideogram · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan conforme los cambias.

•obligatorio

Prompt que describe el relleno de la región enmascarada de la imagen.

•obligatorio image_url
Suelta un archivo o

Fuente de generación proporcionada como URL de imagen; tanto el ancho como la altura deben coincidir exactamente con las dimensiones correspondientes de la máscara.

•obligatorio mask_url
Suelta un archivo o

Máscara de relleno proporcionada mediante URL; tanto el ancho como la altura deben coincidir exactamente con las dimensiones correspondientes de la imagen de entrada.

rendering_speed predeterminado BALANCED

Configuración de velocidad para el renderizado.

num_images predeterminado 1

Cantidad de imágenes que se producirán.

Avanzado images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Suelta un archivo o

Imágenes de referencia de estilo en formato JPEG, PNG o WebP. Su tamaño combinado no debe superar 10 MB.

Preajuste de estilo cuya selección guía la generación de la imagen.

Valor de semilla para la generación de números aleatorios.

Códigos de estilo de imagen, proporcionados como cadenas hexadecimales de 8 caracteres cada una; omite tanto style_reference_images como style al usar esta lista.

Paleta de colores utilizada durante la generación. Especifica un ajuste preestablecido mediante name o colores hexadecimales explícitos mediante members, opcionalmente con pesos.

POST /run/ideogram/v3/edit?wait=20 cotización → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda en localStorage únicamente si marcas Recordar. Obtener una clave de API

Acerca de Ideogram V3 Edit

Rellena un área enmascarada de una imagen según un `prompt`. La imagen (`image_url`) y la máscara (`mask_url`) deben tener dimensiones idénticas. El estilo se puede guiar con imágenes de referencia, `style_codes`, una `color_palette` o un `style_preset`. La velocidad de renderizado es TURBO, BALANCED o QUALITY, y se pueden devolver de 1 a 8 imágenes.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
image_urlsopcional images
Tipourl[] · image
Imágenes de referencia de estilo en formato JPEG, PNG o WebP. Su tamaño combinado no debe superar 10 MB.
rendering_speedopcional
Tipoenum
PredeterminadoBALANCED
TURBOBALANCEDQUALITY
Configuración de velocidad para el renderizado.
color_paletteopcional
Tipoobject
Paleta de colores utilizada durante la generación. Especifica un ajuste preestablecido mediante name o colores hexadecimales explícitos mediante members, opcionalmente con pesos.
color_palette.membersopcional
Tipoobject[]
Lista de miembros de la paleta que define sus colores.
color_palette.members[].rgbobligatorio
Tipoobject
Color del miembro de la paleta expresado como RGB.
color_palette.members[].color_weightopcional
Tiponumber | null
Predeterminado0.5
0.05 – 1
Peso asignado a este color dentro de la paleta.
color_palette.nameopcional
Tipoenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Selección del ajuste preestablecido para la paleta de colores.
style_codesopcional
Tipostring[]
Códigos de estilo de imagen, proporcionados como cadenas hexadecimales de 8 caracteres cada una; omite tanto style_reference_images como style al usar esta lista.
expand_promptopcional
Tipoboolean
Predeterminadotrue
Alternador de uso de MagicPrompt para la generación de la solicitud.
num_imagesopcional num_outputs
Tipointeger
Predeterminado1
1 – 8
Cantidad de imágenes que se producirán.
seedopcional
Tipointeger | null
Valor de semilla para la generación de números aleatorios.
style_presetopcional
Tipoenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 másCOLORING_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
Preajuste de estilo cuya selección guía la generación de la imagen.
promptobligatorio
Tipostring
Prompt que describe el relleno de la región enmascarada de la imagen.
image_urlobligatorio image
Tipourl · image
Fuente de generación proporcionada como URL de imagen; tanto el ancho como la altura deben coincidir exactamente con las dimensiones correspondientes de la máscara.
mask_urlobligatorio mask
Tipourl · image
Máscara de relleno proporcionada mediante URL; tanto el ancho como la altura deben coincidir exactamente con las dimensiones correspondientes de la imagen de entrada.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para video y audio. output es el objeto de resultado propio del modelo.
Campos de salida
images
array of object {url, content_type, file_name, file_size}
seed
integerValor de semilla utilizado para la generación de números aleatorios.

Más modelos: Edición de imágenes

Para agentes de IA: esta página en Markdown está disponible en https://doitong.com/es-MX/developers/models/ideogram/v3/edit.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt