メインコンテンツへスキップ

Mage API · 画像モデル

GPT Image 2 API

精密なプロンプトと読みやすいテキスト

POST https://api.mage.space/v1/gpt_image_2/generate

ひと目でわかる概要

GPT Image 2 API では、POST https://api.mage.space/v1/gpt_image_2/generate を通じて、Mage 上で GPT Image 2 とほかの4つのバリエーションを実行できます。デフォルト設定のリクエストは 9 Gems(約 $0.009)で、サブスクリプションは不要です。GPT Image 2 では、プロンプト内で @handle を使って、保存済みのキャラクターやリファレンスを指定できます。

  • 画像出力
  • 5バリアント
  • 91枚あたりのGems(デフォルト)
  • $0.009米ドル換算の目安

概要

GPT Image 2 APIでできること

OpenAI の GPT Image モデルは、プロンプトに忠実に従い、読みやすい文字を描けます。複数のリファレンス画像からの生成や編集、GPT Image 2.6 でのアニメーション GIF の作成にも対応しています。OpenAI の安全フィルターが適用されます。

生成と編集に使える OpenAI の GPT Image モデル:GPT Image 2、GPT Image 2.5 Flare と Sunburst、GPT Image 2.6 Flare と Sunburst。2.6 の各モデルではアニメーション GIF も作成できます。OpenAI の安全フィルターが適用されます。

入力として image、additional_images を受け付けます。

クイックスタート

GPT Image 2 APIを呼び出す

MAGE_API_KEY を設定し、/gpt_image_2/generate にリクエストを送信して、完了するまで status_url をポーリングします。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

モデル

GPT Image 2 の model_id 値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

model_id名前デフォルト
gpt-image-2GPT Image 2はい
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

オプション

GPT Image 2 のパラメータ

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

フィールド値
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

入力

GPT Image 2 が受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

フィールド役割
image参照画像。
additional_images追加の参照画像。

ルール

GPT Image 2 API で適用されるルール

  • `quality` のレベルはモデルごとに対応が異なり、選んだモデルが対応していないレベルは拒否されます。
  • GPT Image 2.6 のモデルで `output_format` を `gif` に設定すると、アニメーション GIF を作成できます。`frame_count` は 2〜16(デフォルト 9)、`frame_duration_ms` は 20〜2000(デフォルト 200)で指定します。ほかのモデルでは使用できません。`resolution` は適用されず、`aspect_ratio` ごとにフレームサイズが1つに決まり、約 640 ピクセルになります。出力は `.gif` ファイルで、`type` は `image` のままです。
  • GIF の料金は、フレームごとではなく、`quality` とフレーム数の範囲(2〜8、9、10〜12、13〜16)で決まります。下の料金表は静止画の料金です。GIF の料金は、コストの見積もりで確認してください。
  • Mage 上の GIF(過去の生成結果など)を画像入力として渡すと、最初のフレームが使われます。それ以外の場所の GIF は受け付けられません。画像入力に使えるのは JPEG または PNG です。

その他の画像モデル

MageのほかのAI画像生成API

  • 画像 · 90 Gemsから

    Grok Image API

    Grok Imagine、2つのティア

  • 画像 · 37 Gems から

    Guava API

    写真と見間違えるほどのフォトリアリズム

  • 画像 · 20 Gemから

    HiDream API

    高速で多用途、ネガティブプロンプト対応

  • 画像 · 20 Gemから

    Krea 2 API

    数秒で美しいビジュアルを

  • 画像 · 42 Gemsから

    Mango API

    フラッグシップの画像モデルファミリー

  • 画像 · 15 Gemsから

    MiniMax H3 Image API

    ネイティブ1600万画素の画像、オープンウェイト

FAQ

よくある質問

GPT Image 2 APIの料金はいくらですか?
デフォルト設定(GPT Image 2)でのGPT Image 2のリクエストは9 Gems(約$0.009)です。解像度、長さ、バリアントを変えると料金も変わり、正確な請求額はレスポンスで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによってブロックされた場合は返金されません。
GPT Image 2 APIのエンドポイントは何ですか?
MageのAPIキーを指定した Authorization: Bearer ヘッダー付きで、POST https://api.mage.space/v1/gpt_image_2/generate にリクエストします。レスポンスには、結果を確認するためにポーリングする status_url が含まれます。
呼び出せるGPT Image 2のモデルは?
gpt-image-2(GPT Image 2)、gpt-image-2.5-flare(GPT Image 2.5 Flare)、gpt-image-2.5-sunburst(GPT Image 2.5 Sunburst)、gpt-image-2.6-flare(GPT Image 2.6 Flare)、gpt-image-2.6-sunburst(GPT Image 2.6 Sunburst)。デフォルトは GPT Image 2 です。
GPT Image 2は参照画像やキャラクターに対応していますか?
GPT Image 2 は image、additional_images を受け付けます。保存済みのキャラクターやリファレンスは、プロンプト内で @handle を使って指定できます。
ClaudeやChatGPTからGPT Image 2を使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、GPT Image 2を名前で指定してください。アシスタントは get_model でオプションを読み取り、生成前に料金を提示します。
GPT Image 2の生成結果はどのくらいの期間保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

Charactersコミュニティ