はじめに
Ideogram Character は、Ideogram が 2025 年 7 月 29 日に公開した一貫性モデルです。このエンドポイントはその生成モードで、ポートレートを 1 枚アップロードし、まだ存在しないシーンを書くと、モデルがその人物をそこに描き込みます。リクエストの間で学習や保存は行われないので、毎回送られた写真から改めて顔立ちを読み取ります。
主な機能とハイライト
1 枚の画像から似せる
モデルは 1 枚の参考写真から顔の輪郭、目元、生え際、髪型を読み取り、新しい光、衣装、カメラアングルへ運び込みます。テストでは、あご丈の黒いボブとまっすぐな前髪の女性のヘッドショットが、夜のバルコニーでも、楽屋の鏡の前でも、描かれたパルプ小説の表紙でも、その髪型と前髪を保ちました。
3 つの速度段階と 3 つのスタイル
Turbo、Balanced、Quality は描画時間、細部、料金を変え、Auto、Realistic、Fiction は料金を変えずに見た目を変えます。テストでは Turbo の画像が約 20〜35 秒、2 枚の Balanced が約 54 秒、Quality の 1 枚が約 62 秒で返りました。受け取った結果はすべて 992 × 992 の WebP でした。
1 回で何枚も
num_outputs を使うと、同じプロンプトとポートレートから最大 4 枚が返ります。似具合は 1 枚ごとに少しずつ違うので、Turbo で 2〜4 枚出すのが、本番の描画前にいちばん似た 1 枚を見つけるもっとも安い方法です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 新しいシーンを 5,000 文字以内で書きます。場所、服装、ポーズ、光、カメラ。 1 文字以上 · 5000 文字以内 |
reference_image_urls | はい | 似せたい人物のポートレートをちょうど 1 枚。顔が隠れていない鮮明な正面寄りの写真が最適で、JPEG、PNG、WebP、10 MB まで。 1 件以上 · 1 件以内 |
quality | いいえ | turbo、balanced(既定)、quality。上位の段階ほど時間がかかり、1 枚あたりの料金も上がります。 |
style | いいえ | auto(既定)はモデルに任せ、realistic は写真らしく、fiction はイラストやデフォルメ寄りにします。料金は変わりません。 |
num_outputs | いいえ | 同じプロンプトと参考写真から 1〜4 枚。1 枚ごとに課金されます。 |
enable_prompt_expansion | いいえ | MagicPrompt は既定でオンで、短いプロンプトを描画前に膨らませます。長いプロンプトを言葉どおりに使いたいときはオフにします。 デフォルト値: |
negative_prompt | いいえ | 入れたくない要素を 5,000 文字以内で列挙します(任意)。メインのプロンプトと矛盾した場合はメインが優先されます。 5000 文字以内 |
seed | いいえ | 任意の整数。同じ入力で使い回すと 1 か所だけ変えた比較がしやすくなりますが、同じ画像になる保証はありません。 |
料金
選んだ段階(Turbo、Balanced、Quality)で、返ってきた画像 1 枚ごとに課金します。モデルが拒否したリクエストや完了しなかったリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.08 / 枚 |
| $0.12 / 枚 |
| $0.16 / 枚 |
ユースケース
繰り返し登場するキャラクター
漫画のコマ、絵本の見開き、SNS の連載では、毎回同じ主人公が必要です。承認済みのポートレートを 1 枚参考写真として固定し、画像ごとにシーンの文章だけを変えましょう。
ファッションとスタイリングの下書き
1 人のモデルをイブニングドレス、仕立てのスーツ、カジュアルなストリートの装いに置き、本番の撮影前にスタイリングの方向を比べたり、カメラマンにムードと光を伝えたりできます。
企画書や絵コンテのコマ
キャストのヘッドショットを、映画企画の重要な場面に置き換えます。夜のバルコニー、煙ったバー、雨の通り。描いたボードには Fiction、スチルのように見せたいムードフレームには Realistic が向いています。
プロンプトガイドと実践のヒント
言葉は変化に使う
顔はすでに写真から来ているので、プロンプトで描写する必要はありません。代わりに場所、衣装、ポーズ、表情、光、レンズを書き、人物は the woman、the man、she と呼びます。違う髪色や顔立ちを書くと参考写真とぶつかり、たいてい似る度合いが下がります。
きれいな参考写真を用意する
頭から肩までにトリミングし、顔にピントを合わせて光をむらなく当て、サングラスやマスク、目にかかる手や髪は避けます。前髪、そばかす、小さなほくろのような特徴があれば、毎回の結果で確認できる目印になります。
安く試してから格上げする
Turbo で 2〜4 枚出し、いちばん顔が保たれたプロンプトとシードを選び、その組み合わせだけを Balanced か Quality で描き直します。MagicPrompt は既定でオンなので、長く正確に書いたプロンプトを書き換えられたくないときはオフにしてください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/character/text-to-image",
"input": {
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "balanced",
"reference_image_urls": [
"https://example.com/reference.png"
],
"style": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。





