OpenAI标准 API
Images 图像生成
OpenAI 格式的 Images API 使用方法
接口概述
Images API 提供了两种主要的图像生成方式：
- DALL·E 3/2：OpenAI 的图像生成模型，支持高质量图像生成
- 其他模型：支持 Stable Diffusion、Midjourney 等多种图像生成模型
基本信息
| 项目 | 内容 |
|---|---|
| 创建图像 | POST /v1/images/generations |
| 编辑图像 | POST /v1/images/edits |
| 图像变体 | POST /v1/images/variations |
| 认证方式 | Bearer Token |
| 内容类型 | application/json / multipart/form-data |
请求头
Content-Type: application/json
Authorization: Bearer sk-your-api-key创建图像
请求参数
{
"model": "dall-e-3",
"prompt": "一只可爱的橘猫在阳光下打盹，写实风格，高清",
"n": 1,
"size": "1024x1024",
"quality": "standard",
"style": "vivid"
}参数详细说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 图像生成模型 |
prompt | string | 是 | - | 图像描述提示词 |
n | integer | 否 | 1 | 生成图像数量 (1-10) |
size | string | 否 | 1024x1024 | 图像尺寸 |
quality | string | 否 | standard | 图像质量：standard 或 hd |
style | string | 否 | vivid | 图像风格：vivid 或 natural |
支持的模型
| 模型 | 说明 | 支持尺寸 |
|---|---|---|
dall-e-3 | DALL·E 3，最高质量 | 1024x1024, 1024x1792, 1792x1024 |
dall-e-2 | DALL·E 2，经济实惠 | 256x256, 512x512, 1024x1024 |
响应格式
{
"created": 1698830694,
"data": [
{
"url": "{BASE_URL}/generated-images/xxx.png",
"revised_prompt": "A cute orange tabby cat napping in warm sunlight, realistic style, high definition photograph"
}
]
}代码示例
cURL
curl -X POST "{BASE_URL}/v1/images/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "dall-e-3",
"prompt": "一只可爱的橘猫在阳光下打盹，写实风格",
"n": 1,
"size": "1024x1024"
}'Python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="{BASE_URL}/v1"
)
response = client.images.generate(
model="dall-e-3",
prompt="一只可爱的橘猫在阳光下打盹，写实风格",
size="1024x1024",
quality="standard",
n=1
)
print(response.data[0].url)Node.js
import OpenAI from 'openai';
const openai = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: '{BASE_URL}/v1',
});
async function main() {
const response = await openai.images.generate({
model: 'dall-e-3',
prompt: '一只可爱的橘猫在阳光下打盹，写实风格',
size: '1024x1024',
n: 1,
});
console.log(response.data[0].url);
}
main();提示词技巧
1. 描述要具体
❌ 不好的示例：“一只猫”
✅ 好的示例：“一只毛茸茸的橘色短毛猫，正蜷缩在窗边的阳光下打盹，窗外是春天的樱花树，柔和的自然光线，8K 超高清，摄影级画质”
2. 指定风格
- 写实风格：
photorealistic,realistic,photograph,8k uhd - 动漫风格：
anime style,manga,cartoon,illustration - 艺术风格：
oil painting,watercolor,digital art,concept art
3. 指定光照和氛围
soft natural lighting- 柔和自然光dramatic lighting- 戏剧性光影golden hour- 黄金时刻studio lighting- 影棚灯光