Ideogram

Ideogram models are called through one unified, asynchronous job API. Start a task with POST /api/generate, then poll GET /api/generate/{taskId} until it finishes. This family exposes 6 endpoints.

Overview

Every endpoint shares the same envelope — only model and the input fields change. Run any from the Models Market playground.

Authentication

Create an API key at /api-keys, then send it as a Bearer token. Requests from the browser while logged in also work via the session cookie.

Authorization: Bearer <YOUR_API_KEY>

Create Task

POST

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

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

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

Query Result

GET

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

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

Asynchronous

A 200 from Create Task only means the task was accepted — not finished. Poll this endpoint until state becomes success or fail. Failed tasks are not billed.

Endpoints

Model	Task	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

input fields

promptstringrequired

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

image_urlstringrequired

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

mask_urlstringrequired

Mask URL indicating region to inpaint; must match image dimensions

reference_image_urlsarray<string>required

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

rendering_speedenum<string>optional

Speed/quality tradeoff for generation

styleenum<string>optional

Visual style for output image generation

expand_promptbooleanoptional

Enable MagicPrompt enhancement

num_imagesenum<string>optional

Number of images to generate

seedintegeroptional

Random seed for reproducible generation

Example

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

input fields

promptstringrequired

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

image_urlstringrequired

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

reference_image_urlsarray<string>required

Character reference images (1 supported, max 10MB)

rendering_speedenum<string>optional

Generation speed vs quality tradeoff

styleenum<string>optional

Style type for generation

expand_promptbooleanoptional

Enable MagicPrompt enhancement

image_sizeenum<string>optional

Output image dimensions

num_imagesenum<string>optional

Number of images to generate

seedintegeroptional

Random number generator seed

strengthnumberoptional

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

negative_promptstringoptional

Content to exclude from generation (max 500 chars)

image_urlsarray<string>optional

Style reference images (max 10MB total)

reference_mask_urlsstringoptional

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

Example

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

input fields

promptstringrequired

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

reference_image_urlsarray<string>required

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

rendering_speedenum<string>optional

Speed setting for generation

styleenum<string>optional

Style type for generation

expand_promptbooleanoptional

Enable/disable MagicPrompt expansion

num_imagesenum<string>optional

Number of images to generate

image_sizeenum<string>optional

Output image resolution

seedintegeroptional

Random number generator seed for reproducibility

negative_promptstringoptional

Exclude specified elements from generation (max 5000 chars)

Example

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

input fields

promptstringrequired

Description of the image to generate (max 5000 chars)

rendering_speedenum<string>optional

Rendering speed vs quality tradeoff

styleenum<string>optional

Visual style type for generation output

expand_promptbooleanoptional

Whether to use MagicPrompt to enhance the request

image_sizeenum<string>optional

Resolution of the generated image

seedintegeroptional

Seed value for the random number generator

negative_promptstringoptional

Description of what to exclude (max 5000 chars)

Example

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

input fields

promptstringrequired

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

image_urlstringrequired

URL of image to edit; must match mask dimensions

mask_urlstringrequired

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

rendering_speedenum<string>optional

Speed/quality tradeoff for generation

expand_promptbooleanoptional

Whether to apply MagicPrompt enhancement

seedintegeroptional

Random number generator seed for reproducible results

Example

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

input fields

promptstringrequired

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

image_urlstringrequired

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

rendering_speedenum<string>optional

Speed/quality tradeoff for generation

styleenum<string>optional

Visual style for output

expand_promptbooleanoptional

Enable MagicPrompt enhancement

image_sizeenum<string>optional

Output image resolution/aspect ratio

num_imagesenum<string>optional

Number of images to generate

seedintegeroptional

Random number generator seed for reproducibility

strengthnumberoptional

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

negative_promptstringoptional

Content to exclude from generation (max 5000 chars)

Example

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"
  }
}'