Ir al contenido

Ideogram Text to Image

Integrar

ID del modelo ideogram/v3
# 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?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"
  }'

# 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,06 $ 60 créditos de API Ejecutar en esta página

Obtener clave de API
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

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

•obligatorio
rendering_speed predeterminado BALANCED

Configuración de velocidad de renderizado.

image_size predeterminado square_hd

Resolución que se utilizará para la imagen de salida.

num_images predeterminado 1

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

Avanzado negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
predeterminado

Especifica el contenido de imagen no deseado, aunque las descripciones del prompt principal tienen prioridad sobre estas descripciones del prompt negativo.

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.

style

Tipo de estilo utilizado para la generación; es mutuamente excluyente con style_codes.

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 style_reference_images y style al utilizar 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?wait=20 presupuesto → 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?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"
  }'

# 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 solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Ideogram Text to Image

Genera imágenes a partir de un `prompt` con velocidades de renderizado TURBO, BALANCED o QUALITY. Orienta el aspecto mediante imágenes de referencia de estilo (`image_urls`), `style_codes`, una `color_palette`, un `style` o uno de los 62 valores de `style_preset`. Admite hasta 8 imágenes por llamada, un prompt negativo, ampliación opcional del prompt y preajustes de tamaño.

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.
styleopcional
Tipoenum
AUTOGENERALREALISTICDESIGN
Tipo de estilo utilizado para la generación; es mutuamente excluyente con style_codes.
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.
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
image_sizeopcional
Tipoobject
Predeterminadosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Resolución que se utilizará para la imagen de salida.
negative_promptopcional
Tipostring
Predeterminado
Especifica el contenido de imagen no deseado, aunque las descripciones del prompt principal tienen prioridad sobre estas descripciones del prompt negativo.
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/v3",
  "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"
  },
  "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 (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.

Más modelos: Texto a imagen

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