curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "リクエストパラメータが無効です",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "認証に失敗しました。API キーを確認してください。",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "アカウント残高が不足しています",
"type": "payment_required"
}
}
GPT-Image-2.5
GPT-Image-2.5 画像生成
- gpt-image-2.5-flare と gpt-image-2.5-sunburst を提供
- 非同期処理で task_id を返し、後から結果を取得
- テキスト画像生成と最大 16 枚の参照画像を使った編集に対応
- 15 種類のアスペクト比、任意のピクセル寸法、1K / 2K / 4K に対応
- low / medium / high / xhigh / max の品質設定
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "リクエストパラメータが無効です",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "認証に失敗しました。API キーを確認してください。",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "アカウント残高が不足しています",
"type": "payment_required"
}
}
モデルの選び方：
gpt-image-2.5-flare は高速で、日常的な高品質画像、バッチ生成、試作に適しています。gpt-image-2.5-sunburst は編集精度を重視し、完成品レベルの商品画像、広告クリエイティブ、細かな複数回編集に適しています。料金は両モデルで同じです。curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-flare",
"prompt": "雨の窓辺にある居心地のよい読書スペース、暖かなランプの光",
"size": "1:1",
"resolution": "1k",
"quality": "medium",
"n": 1
}'
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KXXXXXXXXXXXXXXX"
}
]
}
{
"error": {
"code": 400,
"message": "リクエストパラメータが無効です",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "認証に失敗しました。API キーを確認してください。",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "アカウント残高が不足しています",
"type": "payment_required"
}
}
認証
モデルの選択
| モデル | 特長 | 推奨用途 |
|---|---|---|
gpt-image-2.5-flare | 高速な標準モデル | SNS、商品画像、ビジュアル検索、試作、バッチ生成 |
gpt-image-2.5-sunburst | 編集精度を優先 | 完成品の商品画像、広告、複数回の精密編集 |
gpt-image-2 と比べて xhigh と max が追加され、medium と high の出力トークンは旧世代の同名レベルのおよそ 4 分の 1 です。
リクエストパラメータ
string
必須
gpt-image-2.5-flare または gpt-image-2.5-sunburst。string
必須
生成または編集する画像の説明。被写体、場面、構図、スタイル、照明、維持または変更する要素を具体的に記述してください。
string
デフォルト:"auto"
出力のアスペクト比または正確なピクセル寸法。
auto：プロンプトまたは参照画像から自動選択- 比率：
1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3 - 正確な寸法（例：
1600x1200）
画像編集では
size を省略すると、入力画像の比率と resolution から出力寸法が計算されます。string
デフォルト:"1k"
解像度：
1k、2k、4k。size が正確なピクセル寸法の場合は無視されます。string
デフォルト:"auto"
画質：
low、medium、high、xhigh、max、auto。xhigh と max は GPT-Image-2.5 専用です。gpt-image-2 に指定すると HTTP 400 になり、自動的な品質低下は行われません。integer
デフォルト:"1"
生成枚数。
1～4 の数値を指定します。string
デフォルト:"png"
出力形式：
png、jpeg、webp。integer
0～100 の圧縮率。jpeg と webp のみ有効です。string
背景：
transparent、opaque、auto。transparent は png または webp と組み合わせてください。JPEG はアルファチャンネルに対応しません。string
デフォルト:"low"
コンテンツ審査レベル：
auto または low。省略時は APIMart が low を明示的に送信し、指定された auto はそのまま使用されます。string[]
画像生成・編集用の参照画像 URL。最大
16 枚で、指定すると編集モードになります。公開アクセス可能な HTTP(S) URL のみ利用できます。ローカル画像は POST /v1/uploads/images でアップロードし、返された url を使用してください。サイズ制約
- 幅と高さはいずれも
16の倍数 - 一辺は
3840ピクセル以下 - 長辺と短辺の比率は
3:1以下 - 総ピクセル数は
655,360～8,294,400
2560×1440 を超える解像度は実験的で、一般的な解像度より安定性が低い場合があります。
比率と解像度の対応
size | 1k | 2k | 4k |
|---|---|---|---|
1:1 | 1024×1024 | 2048×2048 | 2880×2880 |
3:2 | 1536×1024 | 2048×1360 | 3520×2336 |
2:3 | 1024×1536 | 1360×2048 | 2336×3520 |
4:3 | 1024×768 | 2048×1536 | 3312×2480 |
3:4 | 768×1024 | 1536×2048 | 2480×3312 |
5:4 | 1280×1024 | 2560×2048 | 3216×2576 |
4:5 | 1024×1280 | 2048×2560 | 2576×3216 |
16:9 | 1536×864 | 2048×1152 | 3840×2160 |
9:16 | 864×1536 | 1152×2048 | 2160×3840 |
2:1 | 2048×1024 | 2688×1344 | 3840×1920 |
1:2 | 1024×2048 | 1344×2688 | 1920×3840 |
21:9 | 2016×864 | 2688×1152 | 3840×1648 |
9:21 | 864×2016 | 1152×2688 | 1648×3840 |
3:1 | 1536×512 | 3072×1024 | 3840×1280 |
1:3 | 512×1536 | 1024×3072 | 1280×3840 |
編集例
{
"model": "gpt-image-2.5-sunburst",
"prompt": "商品とパッケージの文字を維持し、背景を柔らかなオフホワイトのスタジオに変更して自然な影を追加する",
"image_urls": ["https://example.com/product.png"],
"resolution": "2k",
"quality": "xhigh"
}
送信とタスク照会
送信成功時のタスク ID はdata[0].task_id にあります。タスク状態 API を 2～5 秒ごとに呼び出し、completed または failed になるまで確認してください。複数タスクには POST /v1/tasks/batch を利用できます。
{
"code": 200,
"data": {
"id": "task_01KXXXXXXXXXXXXXXX",
"status": "completed",
"progress": 100,
"cost": 0.01325,
"result": {
"images": [{
"url": ["https://upload.apimart.ai/f/image/example.png"],
"expires_at": 1789000000
}]
},
"usage": {
"input_tokens": 16,
"output_tokens": 439,
"total_tokens": 455
}
}
}
data.result.images[].url[] にあります。早めにダウンロードして保存してください。
| 状態 | 意味 |
|---|---|
submitted | 送信済み |
processing | 生成中 |
completed | 成功。result.images を取得可能 |
failed | 失敗。error.message を確認し、予約額は返金 |
料金
GPT-Image-2.5 は実際のトークン使用量で課金されます。料金ページまたは/api/pricing で現在の料金を確認してください。
| 項目 | 100 万トークンあたり |
|---|---|
| 画像出力 | $30.00 |
| 画像入力 | $8.00 |
| キャッシュ済み画像入力 | $2.00 |
| テキスト入力 | $5.00 |
| キャッシュ済みテキスト入力 | $1.25 |
1024×1024 の quality | 出力トークン | 公式出力コスト |
|---|---|---|
low | 196 | $0.00588 |
medium | 439 | $0.01317 |
high | 1756 | $0.05268 |
xhigh | 3122 | $0.09366 |
max | 7024 | $0.21072 |
quality: "auto" では、選択サイズの max 相当額を先に予約し、完了後に実使用量で精算して差額を解放します。n > 1 の予約額は枚数に比例します。失敗したタスクは自動返金されます。
制限とよくあるエラー
| 項目 | 制限または対処 |
|---|---|
| 1 リクエストの枚数 | 1～4 |
| 参照画像 | 最大 16 枚 |
| 出力形式 | PNG / JPEG / WebP |
| 透明背景 | PNG / WebP のみ |
| 部分画像ストリーミング | 非対応 |
| 無効な品質 | xhigh / max には GPT-Image-2.5 が必要 |
| 無効な寸法 | ピクセル数と比率の範囲内で 16 の倍数を使用 |
Response
integer
レスポンスコード。送信成功時は 200。