画像

Ideogram Character API

提供: Ideogram

参照画像から一貫したキャラクターを生成。

APIキーを取得ドキュメントを読む

~25s
平均生成時間: 17 credits
最低価格

Ideogram v3 Balanced bold event poster with the title 'NEON NIGHTS' and the subtitle 'Live This Saturday' in a vibrant retro design — A bold event poster with the title 'NEON NIGHTS' and the subtitle 'Live This Saturday', vibrant retro design.

プレイグラウンド

Ideogram Characterをここで試す。

model: ideogram-character

プロンプト

アスペクト比

Style

Magic prompt

メディア入力

Character reference

詳細設定

Negative prompt Rendering speed Seed

推定コスト 17–34 クレジット · $0.17–$0.34 Studioで生成

出力サンプル · Ideogram v3 Balanced

料金

シンプルな生成単位課金。

17–34 クレジット/1生成あたり ≈ $0.17–$0.34

料金は選択する解像度とオプションによって異なります。

成功した生成にのみ課金されます。失敗したジョブは自動的に返金されます。
Apiframeの全モデルでひとつのクレジット残高を共有。モデルごとのプランはありません。
無料クレジットで開始。サブスクリプションは不要です。
大きなプランにはボリュームディスカウントがあります。

プランとクレジットパックを見る

スペック

ひと目でわかる。

プロバイダー Ideogram

モデルID ideogram-character

アスペクト比 1:1, 3:4, 4:3, 9:16, 16:9

画像入力対応

平均時間 ~25秒

クイックスタート

Ideogram Character APIの呼び出し方。

APIキーを添えてPOST /v2/images/generateリクエストをひとつ送るだけ。呼び出しはポーリング可能なjobIdを返します。webhook_urlを渡せば、結果は完成と同時にプッシュされます。

ideogram-characterを別のモデルに替えても、他は何も変わりません。

APIキーを取得ドキュメントを読む

generate.js

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "ideogram-character",
    "ideogramParams": {
      "character_reference_image": "https://example.com/input.jpg",
      "style_type": "AUTO",
      "magic_prompt_option": "Auto",
      "negative_prompt": "What you do NOT want to see…"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-character",
        "ideogramParams": {
            "character_reference_image": "https://example.com/input.jpg",
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "negative_prompt": "What you do NOT want to see…"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-character",
        "ideogramParams": {
            "character_reference_image": "https://example.com/input.jpg",
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "negative_prompt": "What you do NOT want to see…"
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

入力スキーマ

Ideogram Characterが受け付けるすべてのフィールドと型、デフォルト値。完全なリファレンスはドキュメントにあります。

フィールド	型	説明
prompt 必須	string	生成する内容のテキスト説明。
model 必須	string	このエンドポイントのモデル識別子。デフォルト:"ideogram-character" · "ideogram-character"
ideogramParams.character_reference_image	string (URL)	Required — the character to keep consistent across generations.
ideogramParams.style_type	string	Style デフォルト:"AUTO" · "AUTO", "GENERAL", "REALISTIC", "DESIGN"
ideogramParams.magic_prompt_option	string	Let Ideogram rewrite your prompt for better results. デフォルト:"Auto" · "Auto", "On", "Off"
ideogramParams.negative_prompt	string	Negative prompt
ideogramParams.rendering_speed	string	Rendering speed デフォルト:"default" · "default", "turbo", "quality"
ideogramParams.seed	number	Reuse a number to reproduce the same result. step 1

Ideogramのバージョン

ApiframeのすべてのIdeogram 画像モデル。パラメータひとつで切り替えられます。

Ideogram Characterに関する質問

Ideogram Characterで出荷する前にチームがよく尋ねる質問。その他はドキュメントをご覧ください。

Ideogram Character の API はありますか？

はい。Apiframe は単一の REST エンドポイント（POST /v2/images/generate、model: "ideogram-character"）で Ideogram Character を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Ideogram の個別アカウントは不要です。

Ideogram Character API の料金はいくらですか？

Ideogram Character は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。

Ideogram Character API はどのように呼び出しますか？

X-API-Key と、model: "ideogram-character" を含む JSON ボディを添えて /v2/images/generate に POST リクエストを送ります。レスポンスで返る jobId を GET /v2/jobs/{id} でポーリングするか、Webhook で結果を受け取ります。

Ideogram Character はどんなパラメータに対応していますか？

Ideogram Character は、共通の prompt・webhook_url に加えて、ideogramParams の下にネストされた 6 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。