AvatarMe 文档API 参考
AvatarMe API 文档
概述
AvatarMe API 允许您将 AI 图片生成集成到您的应用中。所有模型都可通过统一的 API 接口访问。
认证
所有 API 请求都需要 API 密钥。从控制台获取您的密钥。
Authorization: Bearer YOUR_API_KEY生成图片
从文字提示生成图片。
端点
POST https://api.avatarme.app/v1/generate请求体
{
"model": "gpt-image-1.5",
"prompt": "现代咖啡店，温暖的灯光",
"size": "1024x1024",
"quality": "high"
}参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
model | string | 是 | 用于生成的模型 |
prompt | string | 是 | 图片的文字描述 |
size | string | 否 | 图片尺寸（默认：1024x1024） |
quality | string | 否 | 质量级别：standard, high |
可用模型
| 模型 ID | 描述 |
|---|---|
gpt-image-1.5 | OpenAI GPT Image 1.5 |
flux-2 | Black Forest Labs FLUX.2 |
midjourney-v7 | Midjourney v7 |
hidream-i1 | HiDream-I1 |
nano-banana-pro | Google Nano Banana Pro |
recraft | Recraft |
响应
{
"id": "img_abc123",
"url": "https://cdn.avatarme.app/images/abc123.png",
"model": "gpt-image-1.5",
"prompt": "现代咖啡店，温暖的灯光",
"created_at": "2026-01-15T10:30:00Z"
}代码示例
JavaScript/TypeScript
const response = await fetch('https://api.avatarme.app/v1/generate', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'flux-2',
prompt: '专业耳机产品照片',
size: '1024x1024',
}),
});
const data = await response.json();
console.log(data.url);Python
import requests
response = requests.post(
'https://api.avatarme.app/v1/generate',
headers={'Authorization': f'Bearer {API_KEY}'},
json={
'model': 'flux-2',
'prompt': '专业耳机产品照片',
'size': '1024x1024',
}
)
data = response.json()
print(data['url'])cURL
curl -X POST https://api.avatarme.app/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2",
"prompt": "专业耳机产品照片",
"size": "1024x1024"
}'速率限制
| 计划 | 请求/分钟 | 请求/天 |
|---|---|---|
| 免费版 | 5 | 50 |
| 专业版 | 60 | 1,000 |
| 终身版 | 120 | 无限 |
错误代码
| 代码 | 描述 |
|---|---|
| 400 | 请求错误 - 无效参数 |
| 401 | 未授权 - 无效 API 密钥 |
| 429 | 超出速率限制 |
| 500 | 服务器错误 |