画像

Ideogram v3 Balanced API

提供: Ideogram

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

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

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

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

プレイグラウンド

Ideogram v3 Balancedをここで試す。

model: ideogram-v3-balanced

プロンプト

アスペクト比

Style

Magic prompt

メディア入力

Reference image

詳細設定

Negative prompt Rendering speed Seed

推定コスト 11 クレジット · $0.11 Studioで生成

出力

出力はここに表示されます。生成を押すとStudioでこのリクエストが実行されます。

料金

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

11 クレジット/1生成あたり ≈ $0.11

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

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

スペック

ひと目でわかる。

プロバイダー Ideogram

モデルID ideogram-v3-balanced

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

画像入力対応

平均時間 ~25秒

クイックスタート

Ideogram v3 Balanced APIの呼び出し方。

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

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

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

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" }

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…"
        }
    }'

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 v3 Balancedが受け付けるすべてのフィールドと型、デフォルト値。完全なリファレンスはドキュメントにあります。

フィールド	型	説明
prompt 必須	string	生成する内容のテキスト説明。
model 必須	string	このエンドポイントのモデル識別子。デフォルト:"ideogram-v3-balanced" · "ideogram-v3-balanced"
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.image	string (URL)	Reference image (URL)
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 v3 Balancedに関する質問

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

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 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。