生成图像
在给定提示的情况下创建图像。了解更多。
快速上手
该通用接口用于 OpenAI 图像模型；项目内的 GPT Image 2、通义同步生图和 Imagen 也复用 /v1/images/generations，按对应模型页选择模型扩展参数。
| 类型 | 模型 |
|---|---|
| OpenAI | dall-e-2、dall-e-3、gpt-image-1、gpt-image-1-mini、gpt-image-1.5、chatgpt-image-latest |
| GPT Image 2 | gpt-image-2、gpt-image-2-vip、gpt-image-2-1k、gpt-image-2-2k、gpt-image-2-4k |
| 通义同步生图 | z-image、z-image-turbo、qwen-image、wan2.6、wan2.7-image、wan2.7-image-pro |
| Imagen | imagen-4.0-generate-001、imagen-4.0-ultra-generate-001、imagen-4.0-fast-generate-001 |
| Gemini 图片聊天 | gemini-2.0-flash-exp-image-generation、gemini-2.0-flash-exp、gemini-2.5-flash-image、gemini-3-pro-image-preview、gemini-3.1-flash-image-preview |
curl "$BASE_URL/v1/images/generations" \
-H "Authorization: Bearer $NODEKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一张红色山地自行车的产品海报，白色背景，清晰棚拍",
"size": "1024x1024",
"quality": "medium",
"n": 1,
"response_format": "url"
}'from openai import OpenAI
client = OpenAI(api_key="sk-xxx", base_url="https://nodekey.xinghanyun.cn/v1")
image = client.images.generate(
model="gpt-image-2",
prompt="一张红色山地自行车的产品海报，白色背景，清晰棚拍",
size="1024x1024",
quality="medium",
n=1,
)
print(image.data[0].url)图片编辑走 /v1/images/edits；通义编辑模型包含 qwen-image-edit、qwen-image-edit-max、qwen-image-edit-plus 及其日期版本。Gemini 图片聊天模型走 /v1/chat/completions 或 Gemini 原生 generateContent。
Authorization
Bearer
In: header
Request Body
application/json
用于图像生成的模型。dall-e-2、dall-e-3 或 gpt-image-1 之一。默认为 dall-e-2，除非使用特定于 gpt-image-1 的参数。
所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。
要生成的图像数量。必须介于 1 到 10 之间。对于 dall-e-3，仅支持 n=1。
生成的图像的大小。对于 gpt-image-1，必须是 1024x1024、1536x1024（横向）、1024x1536（纵向）或自动（默认值）之一，对于 dall-e-2，必须是 256x256、``512x512 或 1024x1024 之一，对于 dall-e-3，必须是 1024x1024、1792x1024 或 1024x1792 之一。
允许为生成的图像的背景设置透明度。此参数仅支持 gpt-image-1。必须是以下之一 透明、不透明或自动（默认值）。使用自动时，模型将自动确定图像的最佳背景。
如果是透明的，则输出格式需要支持透明度，因此应将其设置为 png（默认值）或 webp。
控制 gpt-image-1 生成的图像的内容审核级别。必须为低， 以进行限制较少的筛选或自动（默认值）。
将生成的图像的质量。
Response Body
application/json
curl -X POST "https://nodekey.xinghanyun.cn/v1/images/generations/" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o", "prompt": "把图片中的自行车改成红色，保持背景和构图不变", "n": 1 }'{
"created": 0,
"data": [
{
"b64_json": "string",
"url": "string"
}
],
"usage": {
"total_tokens": 0,
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": {
"text_tokens": 0,
"image_tokens": 0
}
}
}最后更新于