API DOCUMENT
GPT Image 2 生图接口文档
用户只需要填写下方字段。平台会自动补齐后台配置的默认参数,并在任务成功后扣费,失败不扣费。
创建生图任务
请求地址
POST https://puream.cn/api/ai/gpt-image-2/v1/images/generations
用户需要填写的入参
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
api_key | string | 是 | 在用户中心生成的纯梦平台 API Key。 |
prompt | string | 是 | 图片生成提示词。 |
size | string | 否 | 图片比例或尺寸,例如 9:16、1:1、16:9。 |
请求示例
{
"api_key": "pk_puream_xxxxxxxxxxxxxxxxxxxxx",
"prompt": "北京四合院震撼俯拍",
"size": "9:16"
}返回说明
创建成功后会返回任务 ID。请用任务 ID 查询结果。
查询任务结果
请求地址
GET https://puream.cn/api/ai/gpt-image-2/v1/tasks/任务ID?api_key=你的APIKey
用户需要填写的入参
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
任务ID | string | 是 | 创建任务接口返回的 id。 |
api_key | string | 是 | 用户中心生成的纯梦平台 API Key。 |
计费规则
成功扣费
任务完成成功后扣费。
任务完成成功后扣费。
失败不扣
任务失败会退回冻结金额。
任务失败会退回冻结金额。
余额不足
余额不足时接口返回 402。
余额不足时接口返回 402。