GPT 生图 API
GPT 图像模型适合生成产品图、文章配图、概念图、运营素材和图片编辑任务。实际模型 ID、尺寸、价格和参数以模型广场为准。
请求地址
POST /v1/images/generations
Authorization: Bearer sk-your-dinghui-key
Content-Type: application/json
文生图示例
curl https://www.tophdd.cn/v1/images/generations \
-H "Authorization: Bearer sk-your-dinghui-key" \
-H "Content-Type: application/json" \
-d '{
"model": "your-gpt-image-model",
"prompt": "一张用于 API 聚合服务官网的首屏背景图,干净、专业、蓝绿配色",
"size": "1536x1024",
"n": 1
}'
图片编辑
如果目标模型支持图片编辑,通常需要上传原图和编辑说明。不同客户端或 SDK 的字段名称可能不同,后端接入时请以实际接口返回为准。
示例思路:
保留原图主体,把背景改为干净的科技风控制台界面,不要添加文字。
参数建议
| 任务 | 建议 |
|---|---|
| 官网配图 | 使用横向尺寸,保留文字安全区 |
| 头像 / 图标 | 使用方形尺寸,主体居中 |
| 电商图 | 明确产品、背景、光线和角度 |
| 编辑任务 | 明确保留什么、修改什么、不要什么 |
生产接入建议
- 图片任务建议异步处理。
- 不要把 Base64 图片写入普通日志。
- 对用户上传图片做大小和格式限制。
- 给图像任务设置单独额度。
- 生成结果保存到自己的对象存储后再返回业务系统。
常见错误
| 错误 | 处理 |
|---|---|
model_not_found | 检查图像模型 ID |
invalid_image | 检查图片格式、大小、编码 |
content_policy | 调整 Prompt 或上传内容 |
timeout | 降低尺寸或改为异步任务 |