Image 提供： Ideogram

Ideogram v3 Quality API

最高品質の Ideogram ティア。

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

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

model: "ideogram-v3-quality"

Ideogram v3 Quality premium magazine cover reading 'ATLAS' with a bold masthead and a striking mountain photograph

Ideogram v3 Quality の特長

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

Ideogram v3 Quality で作成

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

Ideogram v3 Quality luxury perfume ad with the label 'NOIR' in elegant serif, a glossy black bottle, and dramatic lighting — A luxury perfume ad with the label 'NOIR' in elegant serif, glossy black bottle, dramatic lighting.

Ideogram v3 Quality detailed packaging design for artisan tea reading 'JASMINE GOLD' with intricate botanical art — A detailed packaging design for artisan tea reading 'JASMINE GOLD' with intricate botanical art.

Ideogram v3 Quality photorealistic billboard mockup reading 'DRIVE ELECTRIC' with a sleek car at golden hour — A photorealistic billboard mockup reading 'DRIVE ELECTRIC' with a sleek car at golden hour.

Ideogram v3 Quality multilingual event poster with the headline in English and Japanese in a refined modern layout — A multilingual event poster with the headline in English and Japanese, refined modern layout.

Ideogram v3 Quality finely detailed storefront sign reading 'THE CORNER BAKERY' in warm hand-painted lettering — A finely detailed storefront sign reading 'THE CORNER BAKERY' in warm hand-painted lettering.

概要

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

機能

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

画像入力対応

平均時間~30秒

クイックスタート

APIキーを添えて POST /v2/images/generate に1回リクエストを送るだけで Ideogram v3 Quality による生成が始まります。レスポンスには、ポーリングまたは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-quality",
        "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-quality",
        "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-quality",
    "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 Quality エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
prompt	string	必須	—	—	生成する内容のテキスト説明。
model	string	必須	"ideogram-v3-quality"	"ideogram-v3-quality"	このエンドポイントのモデル識別子。
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 Quality APIに関するよくある質問をまとめました。

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

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

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

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

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

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

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

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

解決しませんでしたか？

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