跳到主要内容

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降低尺寸或改为异步任务