Image 提供： Ideogram

Ideogram v3 Balanced API

優れたタイポグラフィとポスター制作。速度と品質のバランス型。

Ideogram v3 Balanced を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。

APIキーを取得 Apiframe Studioで使う Ideogram v3 Balanced APIドキュメントを見る

model: "ideogram-v3-balanced"

Ideogram v3 Balanced bold event poster reading 'NEON NIGHTS' with the subtitle 'Live This Saturday' in a vibrant retro design

Ideogram v3 Balanced の特長

1:1, 3:4, 4:3 を含む 5 種類のアスペクト比に対応。
画像から画像への編集と参照画像に対応。
高速処理 — 1回の生成あたり平均約25秒。
Ideogram のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。

Ideogram v3 Balanced で作成

Apiframeの Ideogram v3 Balanced API で生成した出力例です。

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 v3 Balanced coffee packaging label reading 'MORNING RITUAL' with 'Medium Roast' beneath in a clean minimal layout — A coffee packaging label reading 'MORNING RITUAL' with 'Medium Roast' beneath, clean minimal layout.

Ideogram v3 Balanced YouTube thumbnail with the text 'TOP 5 TIPS' in bold yellow, a surprised face, and a bright background — A YouTube thumbnail with the text 'TOP 5 TIPS' in bold yellow, a surprised face, bright background.

Ideogram v3 Balanced vintage travel poster reading 'EXPLORE ICELAND' with a glacier and aurora in art-deco type — A vintage travel poster reading 'EXPLORE ICELAND' with a glacier and aurora, art-deco type.

Ideogram v3 Balanced photorealistic product shot of a skincare bottle labeled 'GLOW' on a marble surface in soft light — A photorealistic product shot of a skincare bottle labeled 'GLOW' on a marble surface, soft light.

Ideogram v3 Balanced greeting card reading 'Happy Birthday' in elegant hand-lettered script with a floral border — A greeting card reading 'Happy Birthday' in elegant hand-lettered script, floral border.

概要

エンドポイント: POST /v2/images/generate
モデルID: ideogram-v3-balanced
パラメータキー: ideogramParams
モダリティ: 画像
プロバイダー: Ideogram
平均完了時間: ~25s

機能

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

画像入力対応

平均時間~25秒

クイックスタート

APIキーを添えて POST /v2/images/generate に1回リクエストを送るだけで Ideogram v3 Balanced による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。

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-v3-balanced",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    }'

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-v3-balanced",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

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-v3-balanced",
    "ideogramParams": {
      "style_type": "AUTO",
      "magic_prompt_option": "Auto",
      "image": "https://example.com/input.jpg",
      "negative_prompt": "What you do NOT want to see…"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

レスポンスとジョブのライフサイクル

生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする（または webhook_url を指定する）と、result フィールドに出力URLが格納されます。

1. 送信レスポンス (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 結果をポーリング

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

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"])

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);

入力スキーマ

Ideogram v3 Balanced エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
prompt	string	必須	—	—	生成する内容のテキスト説明。
model	string	必須	"ideogram-v3-balanced"	"ideogram-v3-balanced"	このエンドポイントのモデル識別子。
ideogramParams.style_type	string	任意	"AUTO"	"AUTO", "GENERAL", "REALISTIC", "DESIGN"	Style
ideogramParams.magic_prompt_option	string	任意	"Auto"	"Auto", "On", "Off"	Let Ideogram rewrite your prompt for better results.
ideogramParams.image	string (URL)	任意	—	—	Reference image (URL)
ideogramParams.negative_prompt	string	任意	—	—	Negative prompt
ideogramParams.rendering_speed	string	任意	"default"	"default", "turbo", "quality"	Rendering speed
ideogramParams.seed	number	任意	—	step 1	Reuse a number to reproduce the same result.

よくある質問

Ideogram v3 Balanced APIに関するよくある質問をまとめました。

Ideogram v3 Balanced の API はありますか？

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

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

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

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

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

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

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

解決しませんでしたか？

サポートに問い合わせる Discordに参加