StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO

GPT Image 2画像生成Beta

  • GPT Image 2（gpt-image-2-beta）モデルはテキストから画像、画像から画像、画像編集モードに対応
  • 非同期処理モード、返却されたタスクIDでステータスを照会
  • 生成された画像リンクは24時間有効です、お早めに保存してください

課金（per_call、解像度ティアごと）：

  • auto または 比率 + resolution：resolution フィールドで課金（1K / 2K / 4K、resolution 参照）
  • 明示的なピクセル 幅x高さ：総ピクセル数で自動的にティア分け — 総ピクセル ≤ 1.7 MP → 1K、総ピクセル > 1.7 MP かつ ≤ 4.4 MP → 2K、総ピクセル > 4.4 MP → 4K
  • n は 1 に固定。quality はこのチャネルでは公開されません

認証

Authorizationstringheader必須

## すべてのAPIにBearer Token認証が必要です ## **APIキーの取得：** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json
modelenum<gpt-image-2-beta>必須

画像生成モデル名

"gpt-image-2-beta"
promptstring必須

生成したい画像を説明するプロンプト、または入力画像の編集方法を説明するプロンプト。2000トークンまで

"A beautiful colorful sunset over the ocean"
sizestring

生成画像のアスペクト比。サポートされている比率から選択するか、`auto` を使用してモデルに決定させます： - `auto`：モデルが自動的に決定（デフォルト） - `1:1`：正方形 - `3:2` / `2:3`：横長 / 縦長 - `4:3` / `3:4`：横長 / 縦長 - `5:4` / `4:5`：横長 / 縦長 - `16:9` / `9:16`：ワイドスクリーン横長 / 縦長 - `21:9` / `9:21`：ウルトラワイド横長 / 縦長 - `2:1` / `1:2`：横長 / 縦長 - `3:1` / `1:3`：パノラマ横長 / 縦長 **明示的なピクセル `幅x高さ`** もサポートされます（例：`1024x1024` / `1920x1080` / `3840x2160`）。明示的なピクセルを使用する場合、`resolution` フィールドは無視され、課金ティアは総ピクセル数で自動的にティア分けされます： - 総ピクセル ≤ 1.7 MP → 1K - 総ピクセル > 1.7 MP かつ ≤ 4.4 MP → 2K - 総ピクセル > 4.4 MP → 4K **ピクセルのハード制限：** - 幅と高さは共に `16` の倍数 - 総ピクセル：`655,360`（約 0.65 MP）～ `8,294,400`（約 8.29 MP） - 各辺 ≤ `3840` - アスペクト比 ≤ `3:1`

"16:9"
resolutionenum<1K | 2K | 4K>

解像度ティア、`size` が比率の場合のみ有効。 **無視される条件：** - `size=auto`：1K ティアで課金（このパラメータを渡す必要はありません） - `size` が明示的な `幅x高さ` ピクセル：本フィールドは無視され、ティアは総ピクセル数で自動的にティア分け（`size` の説明を参照） 価格倍率： - 1K：1× ベース（デフォルト） - 2K：1.7× ベース - 4K：2.6× ベース 横長/正方形の出力寸法（縦長 = 入れ替え）： | 比率 | 1K | 2K | 4K | |---|---|---|---| | 1:1 | 1024×1024 | 2048×2048 | 2880×2880 | | 2:1 | 1456×720 | 2896×1456 | 3840×1920 * | | 3:1 | 1776×592 | 3552×1184 | 3840×1280 * | | 3:2 | 1248×832 | 2512×1680 | 3520×2352 | | 4:3 | 1184×880 | 2368×1776 | 3312×2480 * | | 5:4 | 1152×912 | 2288×1824 | 3216×2576 | | 16:9 | 1360×768 | 2736×1536 | 3840×2160 (UHD) | | 21:9 | 1568×672 | 3136×1344 | 3840×1632 * | * ピクセルバジェットに収まるよう自動ダウンスケール。

"1K"
image_urlsstring<uri>[]

画像から画像への変換および画像編集機能のための参照画像URLリスト **注意:** - リクエストあたり最大 `16` 枚の参照画像 - サポート形式: `.jpeg`, `.jpg`, `.png`, `.webp` - 画像URLはサーバーから直接アクセス可能であるか、直接ダウンロードをトリガーするURL（通常、`.png`、`.jpg`などの画像拡張子で終わるURL）

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
callback_urlstring<uri>

タスク完了時のHTTPSコールバックURL **コールバックタイミング:** - タスクが完了、失敗、またはキャンセルされた時にトリガー - 課金確認後に送信 **セキュリティ制限:** - HTTPSプロトコルのみ - 内部IPアドレスは禁止（127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x など） - URLの長さは`2048`文字以下 **コールバックメカニズム:** - タイムアウト: `10`秒 - 失敗後最大`3`回リトライ（失敗後`1`/`2`/`4`秒） - コールバックレスポンス形式はタスク照会APIと一致 - 2xxステータスコードは成功とみなされ、その他のコードはリトライをトリガー

"https://your-domain.com/webhooks/image-task-completed"

レスポンス

application/json
成功

レスポンスボディ

createdinteger

タスク作成タイムスタンプ

1757156493
idstring

タスク ID

"task-unified-1757156493-imcg5zqt"
modelstring

使用された実際のモデル名

"gpt-image-2-beta"
objectenum<image.generation.task>

タスクオブジェクトタイプ

"image.generation.task"
progressinteger

タスク進捗率（0-100）

0
statusenum<pending | processing | completed | failed>

タスクステータス

"pending"
task_infoobject
{
  "can_cancel": true,
  "estimated_time": 100
}
typeenum<text | image | audio | video>

タスク出力タイプ

"image"
usageobject

使用量と課金情報

{
  "billing_rule": "per_call",
  "credits_reserved": 2.5,
  "user_group": "default"
}
POST/v1/images/generations
curl --request POST \
  --url https://api.starmagic.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2-beta",
  "prompt": "A beautiful colorful sunset over the ocean"
}'
レスポンス: 成功
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2-beta",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}