.png?fit=max&auto=format&n=v_sJS-AFS6goKAv3&q=85&s=e03202fddb83c95be2a503ab9c79163a)
curl --request POST \
--url https://xxx.wengaocloud.com/v3/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2",
"prompt": "一张极简风格的云端工作站海报，蓝白配色"
}
'{
"created": 1779860032,
"background": "opaque",
"output_format": "png",
"quality": "low",
"size": "1024x1024",
"data": [
{
"url": "https://cdn.wengaocloud.com/images/ai/example.png",
"revised_prompt": "一张极简风格的云端工作站海报，蓝白配色，科技感，简约设计"
}
],
"usage": {
"total_tokens": 800,
"input_tokens": 300,
"output_tokens": 500,
"input_tokens_details": {
"text_tokens": 100,
"image_tokens": 200
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}图片生成
图片生成（按张计费）
同步按张计费的图片生成接口。请求体为 JSON，响应直接返回生成结果和用量。
curl --request POST \
--url https://xxx.wengaocloud.com/v3/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2",
"prompt": "一张极简风格的云端工作站海报，蓝白配色"
}
'{
"created": 1779860032,
"background": "opaque",
"output_format": "png",
"quality": "low",
"size": "1024x1024",
"data": [
{
"url": "https://cdn.wengaocloud.com/images/ai/example.png",
"revised_prompt": "一张极简风格的云端工作站海报，蓝白配色，科技感，简约设计"
}
],
"usage": {
"total_tokens": 800,
"input_tokens": 300,
"output_tokens": 500,
"input_tokens_details": {
"text_tokens": 100,
"image_tokens": 200
}
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
模型调用 ID，需要支持 images_generations_v3 endpoint。
示例:
"gpt-image-2"
图片生成提示词，不能为空。
一次返回的图片张数，默认 1，范围 1–10。
必填范围:
1 <= x <= 10生成图片的尺寸，默认 1024x1024。
可用选项:
auto, 1024x1024, 1024x1536, 1536x1024, 2048x2048, 2048x1152, 3840x2160, 2160x3840, 2048x1360, 1360x2048, 1152x2048, 2048x1536, 1536x2048, 2048x880, 880x2048, 688x2048, 2048x688, 2048x1024 背景模式。transparent 需要 output_format=png 或 webp。
可用选项:
transparent, opaque, auto 内容安全策略，默认以模型配置为准。
输出图片格式，默认 png。
可用选项:
png, jpeg, webp JPEG/WebP 压缩质量（0–100），仅对 jpeg 和 webp 格式生效。
必填范围:
0 <= x <= 100响应
图片生成响应，直接返回结果图 URL 和用量统计。
响应创建时间戳（Unix 秒）。
生成图像的背景类型。
输出图片格式。
实际使用的图像质量等级，当前固定为 low。
示例:
"low"
实际返回的图像尺寸。
Hide child attributes
Hide child attributes