StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
GPT Image 1.5 Image Generation
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
画像GPT ImageGPT-Image.1.5

GPT Image 1.5画像生成

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

認証

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-1.5>必須

画像生成モデル名

"gpt-image-1.5"
promptstring必須

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

"A beautiful colorful sunset over the ocean"
sizeenum<1:1 | 2:3 | 3:2 | 1024x1024 | 1024x1536 | 1536x1024>

生成画像のサイズ、2つのフォーマットをサポート: **アスペクト比フォーマット:** - `1:1`: 正方形 - `2:3`: 縦長 - `3:2`: 横長 **ピクセルフォーマット:** - `1024x1024`: 正方形 - `1024x1536`: 縦長 - `1536x1024`: 横長

"1024x1024"
qualityenum<low | medium | high>

生成画像の品質 **サポートされる品質レベル:** - `low`: 低品質、より速い生成 - `medium`: 中品質 - `high`: 高品質、より遅い生成（デフォルト）

"high"
image_urlsstring<uri>[]

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

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
nenum<1>

生成する画像の数、現在は`1`のみサポート

1
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-1.5"
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-1.5",
  "prompt": "A beautiful colorful sunset over the ocean"
}'
レスポンス: 成功
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-1.5",
  "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"
  }
}