開発者リソース
GPT Image 1.5 API ドキュメント
OpenAIのGPT Image 1.5モデルをアプリケーションに統合。シンプルなREST APIでテキストからの画像生成および画像からの画像生成(image-to-image)をサポートします。
1
認証
GPT Image 1.5 APIはBearerトークン認証を使用します。リクエストヘッダーにAPIキーを入力してください。
認証
Authorization: Bearer sk-your-api-key-here
APIキーは安全に保管してください。クライアント側のコードで共有しないでください。
料金
| タイプ | コスト | 説明 |
|---|---|---|
| テキストから画像生成 | 10クレジット | テキストプロンプトから画像を生成します。 |
| 画像から画像生成 | 10クレジット | テキストプロンプトを使用して既存の画像を編集します。 |
2
タスク作成
POST
https://gptimage15.ai/api/generate非同期生成
料金
テキストから画像、画像から画像のどちらであっても、1回の生成リクエストにつき10 Creditsを消費します。
生成タスクを開始します。APIは直ちにtask_idを返し、これを使用して結果をポーリングします。
ボディパラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| prompt | string | 必須 | 画像生成のためのテキスト説明。最大2000文字。 |
| size | string | 任意 | 画像サイズ:1024*1024、1024*1536、または1536*1024。デフォルト:1024*1024 |
| quality | string | 任意 | 画像品質:low、medium、またはhigh。デフォルト:medium |
| images | array | 任意 | 画像から画像モード用。編集する画像のURL配列。 |
| input_fidelity | string | 任意 | 入力画像への忠実度:lowまたはhigh。デフォルト:high。画像から画像モードのみ有効。 |
| callback_url | string | 任意 | タスク完了通知用のWebhook URL。 |
リクエスト例
Text-to-Image (cURL)
curl -X POST https://gptimage15.ai/api/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A serene mountain landscape...",
"size": "1536*1024",
"quality": "high"
}'Image-to-Image (Edit Mode)
{
"prompt": "Add a rainbow in the sky",
"images": [
"https://example.com/landscape.jpg"
],
"input_fidelity": "high",
"quality": "medium"
}成功レスポンス
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "IN_PROGRESS"
}
}エラーレスポンス
{
"code": 400,
"message": "Bad Request: 'prompt' is required.",
"data": null
}3
ステータス確認
GET
https://gptimage15.ai/api/statusこのエンドポイントをポーリングして、タスクの進捗を確認します。5〜10秒ごとのポーリングを推奨します。
クエリパラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
| task_id | string | 生成エンドポイントから受け取ったタスクID。 必須 |
ステータス値
PENDINGタスク待ち行列中IN_PROGRESS処理中SUCCESS完了FAILEDエラー発生cURL
curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
-H "Authorization: Bearer YOUR_API_KEY"レスポンス(進行中)
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "IN_PROGRESS",
"consumed_credits": 10,
"created_at": "2024-12-19T10:00:00Z"
}
}レスポンス(完了)
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "SUCCESS",
"response": [
"https://cdn.example.com/image.png"
]
}
}レスポンス(失敗)
{
"code": 200,
"message": "success",
"data": {
"task_id": "n36abc123def456gptimg",
"status": "FAILED",
"consumed_credits": 0,
"error_message": "Content policy violation detected",
"created_at": "2024-12-19T10:00:00Z",
"request": { ... },
"response": null
}
}エラーコード
| コード | 説明 |
|---|---|
| 200 | 成功 |
| 400 | バッドリクエスト - 無効なパラメータ(プロンプトの欠落、無効なサイズ/品質など) |
| 401 | 認証エラー - APIキーの欠落または無効 |
| 404 | 未検出 - タスクIDが存在しません |
| 500 | 内部サーバーエラー - 再試行するか、サポートにお問い合わせください |