curl --request POST \
--url https://xcompute.us/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium"
}'
import requests
response = requests.post(
"https://xcompute.us/v1/images/generations",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["id"])
{
"id": "task_AVzfphDDvLn189o8FyF07uEzx1skzfJP",
"status": "queued",
"mode": "generate",
"model": "gpt-image-2.5-async",
"created_at": "2026-09-11 03:33:10"
}
图像生成
异步图像生成
提交 GPT Image 2.5 异步图像任务,并通过任务 ID获取结果。
POST
https://xcompute.us
/
v1
/
images
/
generations
curl --request POST \
--url https://xcompute.us/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium"
}'
import requests
response = requests.post(
"https://xcompute.us/v1/images/generations",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["id"])
{
"id": "task_AVzfphDDvLn189o8FyF07uEzx1skzfJP",
"status": "queued",
"mode": "generate",
"model": "gpt-image-2.5-async",
"created_at": "2026-09-11 03:33:10"
}
使用
保存响应中的
gpt-image-2.5-async 提交异步图像生成任务。接口会立即返回任务 ID,适合不希望长时间保持 HTTP 连接的场景。
提交任务
curl --request POST \
--url https://xcompute.us/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium"
}'
import requests
response = requests.post(
"https://xcompute.us/v1/images/generations",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"model": "gpt-image-2.5-async",
"prompt": "未来城市夜景,电影感灯光,无文字",
"size": "1536x1024",
"quality": "medium",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["id"])
参数
string
required
Bearer Token,例如
Authorization: Bearer YOUR_API_KEY。string
default:"application/json"
required
固定使用
application/json。string
default:"gpt-image-2.5-async"
required
固定填写
gpt-image-2.5-async。string
required
图片内容描述。
string
default:"auto"
图片质量,可选
auto、low、medium 或 high。响应
{
"id": "task_AVzfphDDvLn189o8FyF07uEzx1skzfJP",
"status": "queued",
"mode": "generate",
"model": "gpt-image-2.5-async",
"created_at": "2026-09-11 03:33:10"
}
id,然后按照任务查询页面轮询任务状态和结果。
支持尺寸
| 档位 | 支持的 size |
|---|---|
| 标准 | 1024x1024、1536x1024、1024x1536、1024x1365、1365x1024、1088x1920、1920x1088 |
| 高分辨率 | 2048x2048、1712x2560、2560x1712、2048x1536、1152x2048、2048x1152、2880x2880、2560x3840、3840x2560、3840x2880、2160x3840、3840x2160 |
轮询建议
- 每 3 到 5 秒查询一次,最长等待 10 分钟。
- 任务状态为
completed后读取结果 URL。 failed或cancelled时停止轮询,并读取错误信息。- 停止轮询不会取消服务端任务。