GPT Image 1

gpt_image_1

GPT Image 1 是一个 AI 驱动的图像生成模型，可从文本描述创建高质量图像。

调用地址

POST /v1/queue/gpt_image_1 # 创建任务

GET /v1/queue/gpt_image_1/requests/{request_id}/status # 查询状态

GET /v1/queue/gpt_image_1/requests/{request_id}/response # 获取结果

PUT /v1/queue/gpt_image_1/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/gpt_image_1" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red apple on a white table, soft studio lighting.",
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

prompt string 必填

所需图像的文字描述，最大长度为 32000 个字符

n int

要生成的图像数量

范围：1 - 10

默认值：1

size string

生成图像的大小

可选值：1024x1024、1024x1536、1536x1024、auto

默认值：auto

quality string

图像质量等级

可选值：low、medium、high、auto

默认值：auto

background string

生成图像的背景透明度。透明背景仅适用于支持透明通道的输出格式，例如 png 或 webp

可选值：transparent、opaque、auto

默认值：auto

output_format string

Image API 返回图像的文件格式

可选值：png、jpeg、webp

默认值：png

output_compression int

输出图像的压缩等级，仅在 output_format 为 jpeg 或 webp 时生效，例如 output_compression=50 表示按 50% 压缩输出图像

范围：0 - 100

默认值：100

moderation string

GPT Image 生成请求的内容审核严格程度

可选值：auto、low

默认值：auto

user string

代表最终用户的唯一标识

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理