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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url"
}'
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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url",
},
timeout=300,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])
const response = await fetch("https://xcompute.us/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2.5",
prompt: "一只橘猫坐在窗台上看夕阳,水彩插画风格",
size: "1536x1024",
quality: "medium",
n: 1,
response_format: "url",
}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);
{
"created": 1789097054,
"data": [
{
"url": "https://example.com/generated-image.png",
"revised_prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格"
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 1056,
"total_tokens": 1074
}
}
图像生成
GPT Image 2.5 同步图像生成
使用 GPT Image 2.5 同步生成图片。
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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url"
}'
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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url",
},
timeout=300,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])
const response = await fetch("https://xcompute.us/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2.5",
prompt: "一只橘猫坐在窗台上看夕阳,水彩插画风格",
size: "1536x1024",
quality: "medium",
n: 1,
response_format: "url",
}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);
{
"created": 1789097054,
"data": [
{
"url": "https://example.com/generated-image.png",
"revised_prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格"
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 1056,
"total_tokens": 1074
}
}
使用
从
gpt-image-2.5 调用同步图像生成接口。请求会保持 HTTP 连接,直到图片生成完成并返回结果。客户端超时建议设置为至少 300 秒。
请求示例
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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url"
}'
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",
"prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格",
"size": "1536x1024",
"quality": "medium",
"n": 1,
"response_format": "url",
},
timeout=300,
)
response.raise_for_status()
print(response.json()["data"][0]["url"])
const response = await fetch("https://xcompute.us/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2.5",
prompt: "一只橘猫坐在窗台上看夕阳,水彩插画风格",
size: "1536x1024",
quality: "medium",
n: 1,
response_format: "url",
}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).data[0].url);
请求参数
string
required
Bearer Token,例如
Authorization: Bearer YOUR_API_KEY。你可以在 API Key 管理页面 创建密钥。string
default:"gpt-image-2.5"
required
固定填写
gpt-image-2.5。string
required
图片内容描述。支持中文和英文。建议清晰描述主体、环境、构图和风格。
string
default:"1024x1024"
输出尺寸必须使用下方列出的支持值。
string
default:"auto"
图片质量。可选值为
auto、low、medium、high。integer
default:"1"
生成数量。
string
default:"url"
返回格式。建议填写
url。支持尺寸
size 仅支持以下尺寸:
| 档位 | 支持的 size |
|---|---|
| 标准 | 1024x1024、1536x1024、1024x1536、1024x1365、1365x1024、1088x1920、1920x1088 |
| 高分辨率 | 2048x2048、1712x2560、2560x1712、2048x1536、1152x2048、2048x1152、2880x2880、2560x3840、3840x2560、3840x2880、2160x3840、3840x2160 |
成功响应
{
"created": 1789097054,
"data": [
{
"url": "https://example.com/generated-image.png",
"revised_prompt": "一只橘猫坐在窗台上看夕阳,水彩插画风格"
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 1056,
"total_tokens": 1074
}
}
data[0].url 读取生成图片。图片 URL 可能具有有效期,请及时下载并保存到自己的存储服务。
注意事项
- 同步请求通常需要几十秒,客户端超时建议至少为 300 秒。
- 图片尺寸必须使用本文列出的值。
- 生产环境应检查 HTTP 状态码,并在图片生成完成后及时转存。
- 不能保持长连接的业务请使用 GPT Image 2.5 异步图像生成。