Generations（生成图片）

正式环境

https://api.302.ai

POST

/v1/images/generations

1. 功能介绍

根据文本提示生成一张或多张高质量图像，支持：

GPT-Image 系列模型（gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini）

多尺寸、多质量、背景透明、流式输出等精细控制

自带内容审核，可自定义审核严格度

异步 / 同步双模式，适配不同业务场景

2. 请求参数

字段	类型	必填	说明	备注
prompt	string	✅	描述文本	长度 ≤ 32 k（gpt-image-1.5）
model	string	✅	模型	可选：gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
n	int		生成张数	1-10；dall-e-3 仅支持 1
size	string		尺寸	1024x1024、1536x1024（横向）、1024x1536（纵向）、auto ，尺寸选择 `auto` 时，模型会根据提示词自动给出最佳比例。
quality	string		质量	low / medium / high / auto
background	string		背景	transparent / opaque / auto
output_format	string		输出格式	png / jpeg / webp
output_compression	int		压缩率	0-100；仅 jpeg/webp 生效
moderation	string		审核严格度	low（宽松） / auto
stream	bool		流式输出	仅 GPT-Image 系列支持
partial_images	int		流式分片数	0-3；0=仅返回最终图
async	query		是否异步	传 `?async=true` 时返回 task_id

3. 注意事项

✅ 请根据选择的模型严格遵守 prompt 字符长度限制

📏 不同模型支持的尺寸、质量参数不同，需提前确认兼容性

🔒 敏感内容将被系统拦截，moderation参数建议保持默认auto模式

📊 价格按生成图像的Tokens计算，不同模型/质量的Token消耗不同（详见定价部分）

🔄 可通过任务查询接口主动检查异步任务的生成进度

4. 价格

模型	文字输入	文字输出	图片输出	备注
gpt-image-1	5 PTC/1M Tokens		40 PTC/1M Tokens	高品质模型
gpt-image-1-mini	2 PTC/1M Tokens		8 PTC/1M Tokens	高效经济模型
gpt-image-1.5	5 PTC/1M Tokens	10 PTC/1M Tokens	32 PTC/1M Tokens	平衡型模型

最终价格以请求返回的Tokens消耗数量为准
gpt-image-1:价格参考

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "prompt": "A cute baby sea otter",
    "model": "gpt-image-1.5",
    "size": "1024x1024",
    "n": 1,
    "background": "auto",
    "moderation": "auto",
    "output_format": "png"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/images/generations?response_format=url&async=false' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A cute baby sea otter",
    "model": "gpt-image-1.5",
    "size": "1024x1024",
    "n": 1,
    "background": "auto",
    "moderation": "auto",
    "output_format": "png"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "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
    }
}

修改于 2025-12-24 06:28:45

图片编辑（OpenAI格式）

Edits（修改图片）

Generations（生成图片）

1. 功能介绍#

2. 请求参数#

3. 注意事项#