I

Ideogram 4.5 API

文字入りのポスター、ロゴ、画像を 1K または 2K で生成します。画質は 3 段階から選べます。

価格を比較

同じ出力仕様でチャネルの公開価格を比較

他のモデルと比較
出力仕様チャネルチャネルの公開価格所要時間試す
1K
Ideogram公式
参考価格のみ。Yir 経由では利用できません
FAL
所要時間 14 秒
14 秒試す
2K
Ideogram公式
参考価格のみ。Yir 経由では利用できません
FAL
試す
料金の注記

実際にジョブを実行したチャネルの価格で請求されます。フェイルオーバーでチャネルが切り替わると、コストや所要時間が変わる場合があります。

API を使う

コーディングエージェントにコードを任せる、MCP や Skill で会話の中で生成する、または SDK・OpenAI 互換 API で自分で組み込めます。

コーディングエージェントに組み込ませる

組み込み用プロンプトをコピーするか、Codex や Claude で直接開いてください。エージェントがこのページとモデル仕様を読み、送信・待機・結果処理をプロジェクトに書き込みます。

Yir MCP サーバーを追加

ChatGPT、Claude、Cursor に接続し、会話で @Yir と Ideogram 4.5 を指名します。先に料金を提示し、確認してから生成します。

https://gateway.yir.ai/mcp
クライアント別の手順

Claude Code はコマンド 1 行

コンソールで API キーを作成して YIR_API_KEY に設定し、次を実行します:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Yir Skill をインストール

エージェントの実行環境に YIR_API_KEY を設定し、Claude Code、Codex などに追加したら、「Yir の Ideogram 4.5 で…を作って」と頼むだけです。

npx skills add yir-ai/skills
Yir Skill について

パッケージマネージャーで公式 SDK をインストールするか、下のコードスニペットをコピーして始めましょう

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// デフォルトでは環境変数から YIR_API_KEY を読み込みます: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 画像生成ジョブを送信
const job = await client.submitImage({
model: "ideogram/ideogram-4.5",
input: {
type: "text",
prompt: "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
},
parameters: {
quality: "medium",
resolution: "1K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. ジョブの完了と結果の納品を待機
const result = await client.waitForJob(job.id);
console.log("納品ファイル:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

OpenAI プロトコルを使っているプロジェクトや new-api などのゲートウェイなら、Base URL とキーを変えるだけです。 OpenAI 互換ガイド

OpenAI SDK の base_url
https://gateway.yir.ai/openai/v1
new-api のチャネル Base URL
https://gateway.yir.ai/openai
キー
Yir の API Key
モデル ID
ideogram/ideogram-4.5
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/ideogram-4.5",
    "prompt": "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }'

パラメータの概要

よく使うパラメータです。上限は現在のモデルと選択したチャネルによって異なります

API ドキュメント
解像度
resolution
  • 1K
  • 2K

出力解像度の段階です。高解像度ほど精細になり、価格もそれに応じて上がります

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

画面の縦横比です。用途(縦長、バナー、正方形)に合わせて選んでください

入力モード
input_mode
  • テキスト入力

自然言語のプロンプトだけでメディアを生成します

よくある質問

Ideogram 4.5 で開発を始める

同じ仕様をチャネル間で比較し、1 つのウォレットで複数のチャネルを呼び出せます。