Ideogram V3 Character Edit

Integrar

ID del modelo ideogram/character/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/character/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",
    "reference_image_urls": [
      "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"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/character/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
    "reference_image_urls": [
        "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    ],
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/character/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/es-ES/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "ideogram/character/edit",
  "input": {
    "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",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }
}

Llama al modelo Ideogram V3 Character Edit (ideogram/character/edit) a través de Doitong API. Documentación para agentes: https://doitong.com/es-ES/developers/models/ideogram/character/edit.md

POST https://api.doitong.ru/v1/run/ideogram/character/edit?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "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",
  "reference_image_urls": [
    "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  ]
}

Si el estado de la respuesta es "queued" o "running", consulta GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 hasta que sea "succeeded"; los archivos están en outputs[].url. POST https://api.doitong.ru/v1/quote/ideogram/character/edit con el mismo cuerpo devuelve el precio exacto antes de la ejecución.

Esta solicitud: 0,15 $ 150 créditos de API · ≈ 15,98 ₽ Ejecutar en esta página

Obtener clave de API

Ideogram Edición de imágenes Entradas de referencia #character-consistency

Edición enmascarada de Ideogram V3 que conserva la identidad de un personaje de referencia

OpenAPI Markdown

Ideogram · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación 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

Precio

Precio exacto

desde 0,10 $ / imagen

100 créditos de API / imagen · ≈ 10,66 ₽

Esta solicitud: 1 imagen × 0,15 $ 0,15 $ 150 créditos de API · ≈ 15,98 ₽

Ejecutar · 0,15 $

Solo se cobra si la operación tiene éxito; en caso de error, se reembolsa automáticamente.

rendering_speed predeterminado BALANCED

num_outputs predeterminado 1

Reglas de precios

Cuando rendering_speed = BALANCED: 0,15 $ / imagen
Cuando rendering_speed = QUALITY: 0,20 $ / imagen

Se factura por cada imagen generada.

Endpoint de presupuesto: POST /quote/{id}

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

prompt •obligatorio

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

image •obligatorio image_url

Suelta un archivo o

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

mask •obligatorio mask_url

Suelta un archivo o

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

reference_image_urls •obligatorio

Suelta un archivo o

Imágenes de referencia de personajes en formato JPEG, PNG o WebP, con un límite combinado de 10 MB entre todas las referencias. Actualmente solo se admite 1 imagen; las adicionales se ignoran.

rendering_speed predeterminado BALANCED

Configuración de velocidad de renderizado.

num_outputs num_images predeterminado 1

Número de imágenes que se producirán.

Avanzado images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette

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

reference_mask_urls

Suelta un archivo o

Máscaras de referencia de personajes en formato JPEG, PNG o WebP; el tamaño total de todas las referencias no puede superar 10 MB. Actualmente solo se utiliza 1 máscara; las adicionales se ignoran.

seed

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

style_codes

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

color_palette

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/character/edit?wait=20 presupuesto → 0,15 $

# 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/character/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",
    "reference_image_urls": [
      "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"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/character/edit?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
    "reference_image_urls": [
        "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    ],
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/character/edit", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "ideogram/character/edit",
      "input": {
        "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",
        "reference_image_urls": [
          "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
        ]
      },
      "wait_seconds": 20
    }
  }
}

Ejecutar esta solicitud

Clave de API

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

Acerca de Ideogram V3 Character Edit

Rellena una zona enmascarada de `image_url` mediante `mask_url` (ambos deben tener dimensiones idénticas), un `prompt` y una referencia del personaje en `reference_image_urls` (se usa 1 imagen). Es útil para cambiar la pose, la expresión o la ropa. Admite referencias de estilo opcionales, `rendering_speed` y hasta 8 resultados.

Parámetros

Envía el nombre canónico o el nombre nativo, pero 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 de 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 style_reference_images y style al utilizar esta lista.

expand_promptopcional

Tipoboolean

Predeterminadotrue

Alternador de uso de MagicPrompt para generar la solicitud.

num_imagesopcional num_outputs

Tipointeger

Predeterminado1

1 – 8

Número de imágenes que se producirán.

seedopcional

Tipointeger | null

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

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 la anchura como la altura deben coincidir exactamente con las dimensiones correspondientes de la máscara.

mask_urlobligatorio mask

Tipourl · image

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

reference_image_urlsobligatorio

Tipourl[] · image

Imágenes de referencia de personajes en formato JPEG, PNG o WebP, con un límite combinado de 10 MB entre todas las referencias. Actualmente solo se admite 1 imagen; las adicionales se ignoran.

reference_mask_urlsopcional

Tipourl[] · image

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 subida. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/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": 150,
    "usd": "0.15",
    "charged": 150,
    "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",
    "reference_image_urls": [
      "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: conservada para siempre (con pago 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.