圖像系列GPT ImageGPT-Image.1.5

GPT Image 1.5 图像生成

GPT Image 1.5 (gpt-image-1.5) 模型支持文本转图片、图生图、图像编辑等多种生成模式

异步处理模式，使用返回的任务ID 进行查询
生成的图像链接，有效期为24小时，请尽快保存

授權

Authorizationstringheader必填

##所有接口均需要使用Bearer Token进行认证## **获取 API Key ：** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

請求體

application/json

modelenum<gpt-image-1.5>必填

图像生成模型名称

"gpt-image-1.5"

promptstring必填

提示词，描述想要生成的图像，或描述如何编辑已输入的图像，限制为2000token

"海面上绚丽多彩的美丽日落"

sizeenum<1:1 | 2:3 | 3:2 | 1024x1024 | 1024x1536 | 1536x1024>

生成图像的尺寸，支持两种格式： **简化比例格式：** - `1:1`：正方形 - `2:3`：竖版 - `3:2`：横版 **像素格式：** - `1024x1024`：正方形 - `1024x1536`：竖版 - `1536x1024`：横版

"1024x1024"

qualityenum<low | medium | high>

生成图像的质量 **支持的质量等级：** - `low`：低质量，生成速度快 - `medium`：中等质量 - `high`：高质量，生成速度慢（默认）

"high"

image_urlsstring<uri>[]

参考图像URL列表，用于图生图与图像编辑功能 **注意：** - 单次请求支持输入图像数量：`1~16`张 - 单张图像大小：不超过 `50MB` - 支持的文件格式：`.jpeg`、`.jpg`、`.png`、`.webp` - 图像URL需要服务器能直接查看，或者图像URL在访问时会直接进行下载（一般这种URL是以图像的扩展名作为结尾，例如`.png`、`.jpg`）

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

nenum<1>

生成图像的数量，目前仅支持`1`张

callback_urlstring<uri>

任务完成后的HTTPS回调地址 **回调时机：** - 任务完成（completed）、失败（failed）或取消（cancelled）时触发 - 在计费确认完成后发送 **安全限制：** - 仅支持HTTPS协议 - 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等） - URL长度不超过`2048`字符 **回调机制：** - 超时时间：`10`秒 - 失败后最多重试`3`次（会分别在失败的`1`秒/`2`秒/`4`秒后进行重试） - 回调响应体格式与任务查询接口返回的格式一致 - 回调地址若返回2xx状态码视为成功，其他状态码会触发重试

"https://your-domain.com/webhooks/image-task-completed"

回應

application/json

成功

回應體

createdinteger

任务创建时间戳

1757156493

idstring

任务ID

"task-unified-1757156493-imcg5zqt"

modelstring

实际使用的模型名称

"gpt-image-1.5"

objectenum<image.generation.task>

任务的具体类型

"image.generation.task"

progressinteger

任务进度百分比 (0-100)

statusenum<pending | processing | completed | failed>

任务状态

"pending"

task_infoobject

{
  "can_cancel": true,
  "estimated_time": 100
}

typeenum<text | image | audio | video>

任务的输出类型

"image"

usageobject

使用量和计费信息

{
  "billing_rule": "per_call",
  "credits_reserved": 2.5,
  "user_group": "default"
}

POST/v1/images/generations

curl --request POST \
  --url https://api.starmagic.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-1.5",
  "prompt": "海面上绚丽多彩的美丽日落"
}'

回應: 成功

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-1.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

圖像系列GPT ImageGPT-Image.1.5

GPT Image 1.5 图像生成

GPT Image 1.5 (gpt-image-1.5) 模型支持文本转图片、图生图、图像编辑等多种生成模式

异步处理模式，使用返回的任务ID 进行查询
生成的图像链接，有效期为24小时，请尽快保存

授權

Authorizationstringheader必填

Authorization: Bearer YOUR_API_KEY

請求體

application/json

modelenum<gpt-image-1.5>必填

图像生成模型名称

"gpt-image-1.5"

promptstring必填

提示词，描述想要生成的图像，或描述如何编辑已输入的图像，限制为2000token

"海面上绚丽多彩的美丽日落"

sizeenum<1:1 | 2:3 | 3:2 | 1024x1024 | 1024x1536 | 1536x1024>

"1024x1024"

qualityenum<low | medium | high>

生成图像的质量 **支持的质量等级：** - `low`：低质量，生成速度快 - `medium`：中等质量 - `high`：高质量，生成速度慢（默认）

"high"

image_urlsstring<uri>[]

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

nenum<1>

生成图像的数量，目前仅支持`1`张

callback_urlstring<uri>

"https://your-domain.com/webhooks/image-task-completed"

回應

application/json

成功

回應體

createdinteger

任务创建时间戳

1757156493

idstring

任务ID

"task-unified-1757156493-imcg5zqt"

modelstring

实际使用的模型名称

"gpt-image-1.5"

objectenum<image.generation.task>

任务的具体类型

"image.generation.task"

progressinteger

任务进度百分比 (0-100)

statusenum<pending | processing | completed | failed>

任务状态

"pending"

task_infoobject

{
  "can_cancel": true,
  "estimated_time": 100
}

typeenum<text | image | audio | video>

任务的输出类型

"image"

usageobject

使用量和计费信息

{
  "billing_rule": "per_call",
  "credits_reserved": 2.5,
  "user_group": "default"
}

POST/v1/images/generations

curl --request POST \
  --url https://api.starmagic.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-1.5",
  "prompt": "海面上绚丽多彩的美丽日落"
}'

回應: 成功

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-1.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}