Generations（画像生成）

1. 機能紹介

テキストの指示に基づいて、1枚または複数枚の高品質な画像を生成し、以下をサポートします：
-GPT-Imageシリーズモデル（gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini）

多サイズ、多品質、背景透明、ストリーミング出力などの細かい制御

コンテンツオーディット機能を搭載し、オーディットの厳格度をカスタマイズ可能

非同期 / 同期のデュアルモードで、異なるビジネスシーンに対応します

2. リクエストパラメータ

フィールド	タイプ	必須	説明	備考
プロンプト	文字列	✅	説明テキスト	長さ ≤ 32 k（gpt-image-1.5）
モデル	文字列	✅	モデル	オプション：gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
n	int		生成枚数	1-10；dall-e-3は1のみサポート
サイズ	文字列		サイズ	1024x1024、1536x1024（横）、1024x1536（縦）、auto 、サイズを `auto` に選択すると、モデルはプロンプトに基づいて自動的に最適な比率を提示します。
quality	文字列		品質	低 / 中 / 高 / 自動
背景	文字列		背景	透明 / 不透明 / 自動
output_format	文字列		出力形式	png / jpeg / webp
output_compression	int		圧縮率	0-100；jpeg/webpのみ有効
モデレーション	文字列		コンテンツオーディットの厳格度	low（緩やか） / auto
stream	bool		ストリーミング出力	GPT-Imageシリーズのみサポート
partial_images	int		ストリーミング分割数	0-3；0=最終画像のみ返す
async	query		非同期かどうか	`?async=true` を渡した場合、task_id を返す

3. 注意事項

✅ 選択したモデルに応じて、厳密にプロンプトの文字数制限を遵守してください

📏 異なるモデルがサポートするサイズや品質パラメータは異なるため、互換性を事前に確認する必要があります。

🔒 システムによりセンシティブなコンテンツがブロックされます。moderationパラメータはデフォルトのautoモードのままにすることをおすすめします。

📊 価格は生成画像のトークン数に基づいて計算され、異なるモデル/品質でトークン消費量が異なります（詳細は価格設定のセクションを参照）

🔄 タスク照会インターフェースを通じて非同期タスクの生成進捗状況を能動的に確認することができます

4. 価格

モデル	テキスト入力	テキスト出力	画像出力	備考
gpt-image-1	5 PTC/1Mトークン		40 PTC/1Mトークン	高品質モデル
gpt-image-1-mini	2 PTC/1M Tokens		8 PTC/1M Tokens	高効率で経済的なモデル
gpt-image-1.5	5 PTC/1Mトークン	10 PTC/1Mトークン	32 PTC/1Mトークン	バランス型モデル

最終価格はリクエスト返却時のTokens消費数に準拠します
gpt-image-1:価格参考

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

Example

{
    "background": "opaque",
    "created": 1765956636,
    "data": [
        {
            "url": "https://file.302.ai/gpt/imgs/20251217/cf55103f979340a0b3e92ddf38d33478.png"
        }
    ],
    "output_format": "png",
    "quality": "medium",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 12,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 12
        },
        "output_tokens": 1414,
        "output_tokens_details": {
            "image_tokens": 1056,
            "text_tokens": 358
        },
        "total_tokens": 1426
    }
}

1. 機能紹介#

2. リクエストパラメータ#

3. 注意事項#