Ideogram

Los modelos de Ideogram se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 6 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

POST

POST https://api.lithovas.com/api/generate

Cuerpo: { "model": "<slug>", "input": { … } }

Respuesta: { "taskId": "<id>", "state": "waiting" }

Consultar resultado

GET

GET https://api.lithovas.com/api/generate/<taskId>

Respuesta: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asíncrono

Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

Modelo	Tarea	model slug
Ideogram	Image Editing	ideogram/character-edit
Ideogram	Image Editing	ideogram/character-remix
Ideogram	Image Editing	ideogram/character
Ideogram V3	Text to Image	ideogram/v3-text-to-image
Ideogram V3 Edit	Image Editing	ideogram/v3-edit
Ideogram V3 Remix	Image Editing	ideogram/v3-remix

Ideogram · Image Editing

POSTImage Editingideogram/character-edit

campos input

promptstringobligatorio

Text prompt to fill the masked image area (max 5000 chars)

image_urlstringobligatorio

Image URL to edit; must match mask dimensions (JPEG/PNG/WebP, max 10MB)

mask_urlstringobligatorio

Mask URL indicating region to inpaint; must match image dimensions

reference_image_urlsarray<string>obligatorio

Character reference images (1 supported, max 10MB total)

rendering_speedenum<string>opcional

Speed/quality tradeoff for generation

styleenum<string>opcional

Visual style for output image generation

expand_promptbooleanopcional

Enable MagicPrompt enhancement

num_imagesenum<string>opcional

Number of images to generate

seedintegeropcional

Random seed for reproducible generation

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/character-edit",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "image_url": "https://example.com/input.jpg",
    "mask_url": "example",
    "reference_image_urls": [
      "https://example.com/input.jpg"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "num_images": "1",
    "seed": 42
  }
}'

Ideogram · Image Editing

POSTImage Editingideogram/character-remix

campos input

promptstringobligatorio

Text description to remix the image with (max 5000 chars)

image_urlstringobligatorio

Image URL to remix (JPEG/PNG/WebP, max 10MB)

reference_image_urlsarray<string>obligatorio

Character reference images (1 supported, max 10MB)

rendering_speedenum<string>opcional

Generation speed vs quality tradeoff

styleenum<string>opcional

Style type for generation

expand_promptbooleanopcional

Enable MagicPrompt enhancement

image_sizeenum<string>opcional

Output image dimensions

num_imagesenum<string>opcional

Number of images to generate

seedintegeropcional

Random number generator seed

strengthnumberopcional

Input image influence strength (0.1-1.0, step 0.1)

negative_promptstringopcional

Content to exclude from generation (max 500 chars)

image_urlsarray<string>opcional

Style reference images (max 10MB total)

reference_mask_urlsstringopcional

Masks for character references (1 supported, max 10MB)

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/character-remix",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "image_url": "https://example.com/input.jpg",
    "reference_image_urls": [
      "https://example.com/input.jpg"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 42,
    "strength": 0.8,
    "negative_prompt": "",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "reference_mask_urls": ""
  }
}'

Ideogram · Image Editing

POSTImage Editingideogram/character

campos input

promptstringobligatorio

The prompt to fill the masked part of the image (max 5000 chars)

reference_image_urlsarray<string>obligatorio

Character reference images (1 supported, max 10MB total)

rendering_speedenum<string>opcional

Speed setting for generation

styleenum<string>opcional

Style type for generation

expand_promptbooleanopcional

Enable/disable MagicPrompt expansion

num_imagesenum<string>opcional

Number of images to generate

image_sizeenum<string>opcional

Output image resolution

seedintegeropcional

Random number generator seed for reproducibility

negative_promptstringopcional

Exclude specified elements from generation (max 5000 chars)

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/character",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "reference_image_urls": [
      "https://example.com/input.jpg"
    ],
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": true,
    "num_images": "1",
    "image_size": "square_hd",
    "seed": 42,
    "negative_prompt": ""
  }
}'

Ideogram V3 · Text to Image

POSTText to Imageideogram/v3-text-to-image

campos input

promptstringobligatorio

Description of the image to generate (max 5000 chars)

rendering_speedenum<string>opcional

Rendering speed vs quality tradeoff

styleenum<string>opcional

Visual style type for generation output

expand_promptbooleanopcional

Whether to use MagicPrompt to enhance the request

image_sizeenum<string>opcional

Resolution of the generated image

seedintegeropcional

Seed value for the random number generator

negative_promptstringopcional

Description of what to exclude (max 5000 chars)

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3-text-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "rendering_speed": "TURBO",
    "style": "AUTO",
    "expand_prompt": false,
    "image_size": "square",
    "seed": 42,
    "negative_prompt": "example"
  }
}'

Ideogram V3 Edit · Image Editing

POSTImage Editingideogram/v3-edit

campos input

promptstringobligatorio

Text describing what to fill in masked area (max 5000 chars)

image_urlstringobligatorio

URL of image to edit; must match mask dimensions

mask_urlstringobligatorio

URL of mask indicating areas to inpaint; must match image dimensions

rendering_speedenum<string>opcional

Speed/quality tradeoff for generation

expand_promptbooleanopcional

Whether to apply MagicPrompt enhancement

seedintegeropcional

Random number generator seed for reproducible results

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3-edit",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "image_url": "https://example.com/input.jpg",
    "mask_url": "example",
    "rendering_speed": "BALANCED",
    "expand_prompt": true,
    "seed": 42
  }
}'

Ideogram V3 Remix · Image Editing

POSTImage Editingideogram/v3-remix

campos input

promptstringobligatorio

Text prompt to remix the image with (max 5000 chars)

image_urlstringobligatorio

URL of image to remix (JPEG/PNG/WebP, max 10MB)

rendering_speedenum<string>opcional

Speed/quality tradeoff for generation

styleenum<string>opcional

Visual style for output

expand_promptbooleanopcional

Enable MagicPrompt enhancement

image_sizeenum<string>opcional

Output image resolution/aspect ratio

num_imagesenum<string>opcional

Number of images to generate

seedintegeropcional

Random number generator seed for reproducibility

strengthnumberopcional

Influence of input image (0.01-1.0, step 0.01)

negative_promptstringopcional

Content to exclude from generation (max 5000 chars)

Ejemplo

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram/v3-remix",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "image_url": "https://example.com/input.jpg",
    "rendering_speed": "TURBO",
    "style": "AUTO",
    "expand_prompt": false,
    "image_size": "square",
    "num_images": "1",
    "seed": 42,
    "strength": 1,
    "negative_prompt": "example"
  }
}'