マーケットサポート← アプリに戻る

Ideogram

Ideogram モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 6 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

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

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

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

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
IdeogramImage Editingideogram/character-edit
IdeogramImage Editingideogram/character-remix
IdeogramImage Editingideogram/character
Ideogram V3Text to Imageideogram/v3-text-to-image
Ideogram V3 EditImage Editingideogram/v3-edit
Ideogram V3 RemixImage Editingideogram/v3-remix

Ideogram · Image Editing

POSTImage Editingideogram/character-edit
input フィールド
promptstring必須

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

image_urlstring必須

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

mask_urlstring必須

Mask URL indicating region to inpaint; must match image dimensions

reference_image_urlsarray<string>必須

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

rendering_speedenum<string>任意

Speed/quality tradeoff for generation

styleenum<string>任意

Visual style for output image generation

expand_promptboolean任意

Enable MagicPrompt enhancement

num_imagesenum<string>任意

Number of images to generate

seedinteger任意

Random seed for reproducible generation

例
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 フィールド
promptstring必須

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

image_urlstring必須

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

reference_image_urlsarray<string>必須

Character reference images (1 supported, max 10MB)

rendering_speedenum<string>任意

Generation speed vs quality tradeoff

styleenum<string>任意

Style type for generation

expand_promptboolean任意

Enable MagicPrompt enhancement

image_sizeenum<string>任意

Output image dimensions

num_imagesenum<string>任意

Number of images to generate

seedinteger任意

Random number generator seed

strengthnumber任意

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

negative_promptstring任意

Content to exclude from generation (max 500 chars)

image_urlsarray<string>任意

Style reference images (max 10MB total)

reference_mask_urlsstring任意

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

例
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 フィールド
promptstring必須

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

reference_image_urlsarray<string>必須

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

rendering_speedenum<string>任意

Speed setting for generation

styleenum<string>任意

Style type for generation

expand_promptboolean任意

Enable/disable MagicPrompt expansion

num_imagesenum<string>任意

Number of images to generate

image_sizeenum<string>任意

Output image resolution

seedinteger任意

Random number generator seed for reproducibility

negative_promptstring任意

Exclude specified elements from generation (max 5000 chars)

例
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 フィールド
promptstring必須

Description of the image to generate (max 5000 chars)

rendering_speedenum<string>任意

Rendering speed vs quality tradeoff

styleenum<string>任意

Visual style type for generation output

expand_promptboolean任意

Whether to use MagicPrompt to enhance the request

image_sizeenum<string>任意

Resolution of the generated image

seedinteger任意

Seed value for the random number generator

negative_promptstring任意

Description of what to exclude (max 5000 chars)

例
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 フィールド
promptstring必須

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

image_urlstring必須

URL of image to edit; must match mask dimensions

mask_urlstring必須

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

rendering_speedenum<string>任意

Speed/quality tradeoff for generation

expand_promptboolean任意

Whether to apply MagicPrompt enhancement

seedinteger任意

Random number generator seed for reproducible results

例
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 フィールド
promptstring必須

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

image_urlstring必須

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

rendering_speedenum<string>任意

Speed/quality tradeoff for generation

styleenum<string>任意

Visual style for output

expand_promptboolean任意

Enable MagicPrompt enhancement

image_sizeenum<string>任意

Output image resolution/aspect ratio

num_imagesenum<string>任意

Number of images to generate

seedinteger任意

Random number generator seed for reproducibility

strengthnumber任意

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

negative_promptstring任意

Content to exclude from generation (max 5000 chars)

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