图像生成
TopRouter 支持多种图像生成模型,通过统一的 API 接口即可调用 DALL-E 3、GPT Image、Flux 等模型生成高质量图像。
API 端点
POST https://toprouter.cc/images/generations支持的模型
| 模型 | 模型 ID | 特点 |
|---|---|---|
| DALL-E 3 | openai/dall-e-3 | OpenAI 经典图像生成模型 |
| GPT Image | openai/gpt-image-1 | 最新 GPT 图像生成模型 |
| Flux | flux | 高质量开源图像生成 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✅ | 模型 ID |
prompt | string | ✅ | 图像描述文本 |
n | integer | ❌ | 生成图像数量,默认 1 |
size | string | ❌ | 图像尺寸,如 1024x1024 |
quality | string | ❌ | 图像质量,standard 或 hd |
response_format | string | ❌ | 返回格式:url 或 b64_json |
使用示例
Python
python
from openai import OpenAI
client = OpenAI(
base_url="https://toprouter.cc",
api_key="your-api-key"
)
# 使用 DALL-E 3 生成图像
response = client.images.generate(
model="openai/dall-e-3",
prompt="一只可爱的橘猫坐在窗台上看日落,水彩画风格",
size="1024x1024",
quality="standard",
n=1
)
image_url = response.data[0].url
print(f"图像链接:{image_url}")GPT Image 模型
python
from openai import OpenAI
client = OpenAI(
base_url="https://toprouter.cc",
api_key="your-api-key"
)
response = client.images.generate(
model="openai/gpt-image-1",
prompt="未来城市的天际线,赛博朋克风格,霓虹灯光,高清细节",
size="1024x1024",
n=1
)
image_url = response.data[0].url
print(f"图像链接:{image_url}")TypeScript
typescript
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://toprouter.cc',
apiKey: 'your-api-key',
});
const response = await client.images.generate({
model: 'openai/dall-e-3',
prompt: '一只可爱的橘猫坐在窗台上看日落,水彩画风格',
size: '1024x1024',
quality: 'standard',
n: 1,
});
console.log('图像链接:', response.data[0].url);cURL
bash
curl https://toprouter.cc/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{
"model": "openai/dall-e-3",
"prompt": "一只可爱的橘猫坐在窗台上看日落,水彩画风格",
"size": "1024x1024",
"quality": "standard",
"n": 1
}'响应格式
json
{
"created": 1700000000,
"data": [
{
"url": "https://example.com/generated-image.png",
"revised_prompt": "一只可爱的橘色猫咪安静地坐在窗台上..."
}
]
}提示词技巧
基本原则
- 描述具体:详细描述您想要的画面内容
- 指定风格:如水彩、油画、摄影、赛博朋克等
- 注明细节:光照、角度、色调、氛围等
- 标注质量:如高清、4K、精细细节等
提示词示例
💡 优秀提示词示例
风景画
"日落时分的富士山,前景是粉色的樱花树,湖面倒映着金色的天空,日式水彩画风格,柔和的色调"
产品设计
"极简设计的智能手表,白色表盘,金属表带,45度角拍摄,白色背景,专业产品摄影风格"
角色插画
"一位身穿蓝色长袍的年轻法师,手持发光的魔杖,站在古老的图书馆中,奇幻风格,精细细节"
图像尺寸
不同模型支持的尺寸可能有所不同:
| 尺寸 | 比例 | 适用场景 |
|---|---|---|
1024x1024 | 1:1 | 社交媒体头像、产品图 |
1024x1792 | 9:16 | 手机壁纸、竖版海报 |
1792x1024 | 16:9 | 横版封面、网站横幅 |
⚠️ 注意事项
- 图像生成通常需要几秒到十几秒的时间
- 生成的图像 URL 有时效性,建议及时下载保存
- 不同模型的费用不同,请关注用量
