Ir al contenido

Ideogram V2 Edit

Integrar

Id del modelo 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"

Esta solicitud: 0,08 $ 80 créditos de API Ejecutar en esta página

Obtener clave de API
Ideogram Edición de imágenes #realism#typography

Inpainting basado en máscaras de Ideogram V2 que rellena un área enmascarada a partir de un prompt

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, conservadas 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 al modificarlos.

•obligatorio

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

•obligatorio image_url
Suelta un archivo o

Proporciona el origen de generación como una URL de imagen, asegurándote de que la imagen de origen y la máscara tengan dimensiones idénticas.

•obligatorio mask_url
Suelta un archivo o

Proporciona una máscara de inpainting mediante URL, asegurándote de que sus dimensiones sean iguales a las de la imagen de entrada.

Avanzado style · seed · expand_prompt
style predeterminado auto

Estilo visual de la imagen de salida.

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

POST /run/ideogram/v2/edit?wait=20 cotización → 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"

Ejecutar esta solicitud

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

Acerca de Ideogram V2 Edit

Edita una imagen rellenando una región enmascarada. Requiere `image_url`, `mask_url` (con las mismas dimensiones que la imagen) y un `prompt` para la parte rellenada. Admite opcionalmente `style` (auto, general, realistic, design, render_3D, anime), `expand_prompt` y `seed`.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
promptobligatorio
Tipostring
Prompt que describe el relleno de la región enmascarada de la imagen.
image_urlobligatorio image
Tipourl · image
Proporciona el origen de generación como una URL de imagen, asegurándote de que la imagen de origen y la máscara tengan dimensiones idénticas.
mask_urlobligatorio mask
Tipourl · image
Proporciona una máscara de inpainting mediante URL, asegurándote de que sus dimensiones sean iguales a las de la imagen de entrada.
seedopcional
Tipointeger | null
Valor de semilla para la generación de números aleatorios.
styleopcional
Tipoenum
Predeterminadoauto
autogeneralrealisticdesignrender_3Danime
Estilo visual de la imagen de salida.
expand_promptopcional
Tipoboolean
Predeterminadotrue
Controla si MagicPrompt amplía el prompt.
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/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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra 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 vídeo 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á en https://doitong.com/es/developers/models/ideogram/v2/edit.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt