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

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://97ai.97claude.com/api/generate

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

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

結果の照会

GET
GET https://97ai.97claude.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 describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/character-edit",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Ideogram · Image Editing

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

Text prompt describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/character-remix",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Ideogram · Image Editing

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

Text prompt describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/character",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Ideogram V3 · Text to Image

POSTText to Imageideogram/v3-text-to-image
input フィールド
promptstring必須

Text prompt describing the desired output.

aspect_ratiostring任意

Output aspect ratio, e.g. "1:1", "16:9".

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/v3-text-to-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Ideogram V3 Edit · Image Editing

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

Text prompt describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/v3-edit",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Ideogram V3 Remix · Image Editing

POSTImage Editingideogram/v3-remix
input フィールド
promptstring必須

Text prompt describing the desired output.

image_urlsstring[]必須

One or more source image URLs to condition on.

例
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/v3-remix",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'