高级版专享 API
ViNano AI API
强大的 AI 图片生成 REST API，几行代码即可集成到您的应用中
API 使用要求
- 需要订阅高级版（Advanced Plan）
- 年付费用户：200 次/分钟速率限制
- 月付费用户：20 次/分钟速率限制
✉️
值得期待
为需要大规模图像处理的开发者而生
⚡
闪电般快速
通过我们优化的API基础设施，在毫秒内处理图像
🔧
简单集成
RESTful API，配有全面的文档和多种语言的SDK
💰
灵活定价
按需付费，透明且对开发者友好的定价
API 调用说明
了解如何使用 ViNano AI API 进行图片生成
快速开始
几行代码即可集成 AI 图片生成功能
API 端点
POST https://vinano.ai/api/v2/images/generatecurl -X POST https://vinano.ai/api/v2/images/generate \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "prompt=a beautiful sunset over the ocean" \
-F "model=gemini-2.5-flash-image-preview" \
-F "aspectRatio=16:9" \
-F "googleSearch=false" \
-F "mode=txt2img"请求参数
| 参数名 | 类型 | 必填 | 为开发者打造的强大图像编辑API。用自然语言在毫秒内转换图像。 |
|---|---|---|---|
| prompt | string | No* | 生成图片的提示词（最多2000字符） |
| image | File / File[] | No* | 上传的图片文件（支持多个） |
| imageUrl | string / string[] | No* | Existing image URL(s) (supports multiple URLs) |
| model | string | No | AI 模型，支持 gemini-2.5-flash-image-preview, sora_image |
| aspectRatio | string | No | 宽高比。所有模型支持：auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3。ViNano AI 2（gemini-3.1-pro-image-preview）额外支持：4:1, 1:4, 8:1, 1:8 |
| mode | string | No | 可选的生成模式，例如 photo_restoration（老照片修复）、figure、meme 等 查看所有模式 |
| hdPro | boolean | No | 是否使用高清模式（消耗30积分，普通模式10积分） |
| img_size | string | No | 图片尺寸: 1k, 2k, 4k。仅 Nano Banana 2 / Pro 支持。积分消耗 — Nano Banana 2 (gemini-3.1-pro-image-preview): 1k=25, 2k=35, 4k=60；Nano Banana Pro (gemini-3-pro-image-preview): 1k=30, 2k=50, 4k=80 |
| googleSearch | boolean | No | 启用 Google 搜索增强（仅 gemini-3.1-pro-image-preview / Nano Banana 2 支持，默认 false） |
* prompt 或 image 至少需要提供一个
支持的模型
- gemini-2.5-flash-image-preview- Nano Banana（默认模型）
- gemini-3.1-pro-image-preview- Nano Banana 2（支持扩展宽高比 4:1, 1:4, 8:1, 1:8）
- gemini-3-pro-image-preview- Nano Banana Pro
- sora_image- GPT-Image 2
- Seedance-5.0- Seedance 5.0（仅 2K/3K，支持文生图 / 图生图，支持联网生成）
- Z-Image- ViNano Basic（Z-Image，仅文生图）
响应格式
成功响应 (200)
{
"status": 200,
"images": ["https://example.com/generated-image.jpg"],
"imageDetails": [{
"width": 1024,
"height": 1024,
"filesize": 524288
}],
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"prompt": "a beautiful sunset",
"model": "gemini-2.5-flash-image-preview",
"credits": {
"cost": 10
}
}⚡ 异步图片生成 API
提交任务获取 task_id，然后轮询状态接口直到生成完成。
第一步 — 提交异步任务
POST https://vinano.ai/api/v1/images/async第二步 — 轮询任务状态
GET https://vinano.ai/api/v1/images/task-status?task_id={task_id}# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "prompt=a beautiful sunset" \
-F "model=gemini-2.5-flash-image-preview"
# Response (202):
# {
# "status": 202,
# "task_id": "550e8400-e29b-41d4-a716-446655440000",
# "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
# "model": "gemini-2.5-flash-image-preview",
# "credits": { "cost": 10 }
# }
# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_TOKEN"
# Response when completed:
# {
# "status": 200,
# "images": ["https://example.com/generated-image.jpg"],
# "imageDetails": [{
# "width": 1024,
# "height": 1024,
# "filesize": 524288
# }],
# "uuid": "550e8400-e29b-41d4-a716-446655440000",
# "prompt": "a beautiful sunset",
# "model": "gemini-2.5-flash-image-preview",
# "credits": {
# "cost": 10
# }
# }错误码说明
| 状态码 | 为开发者打造的强大图像编辑API。用自然语言在毫秒内转换图像。 |
|---|---|
| 400 | 缺少必要参数或参数验证失败 |
| 401 | API Token 无效、缺失或格式错误 |
| 403 | 账户被禁用、未订阅高级版或无权限使用 API |
| 413 | 文件大小超过限制（100MB） |
| 429 | 请求频率超限（超过每分钟限制） |
| 495 | 积分不足 |
| 500 | 服务器内部错误或图片生成失败 |
最佳实践
妥善保管 API Token
不要将 API Token 分享给他人或公开在代码仓库中
实现错误处理
处理所有可能的错误码，特别是 429（速率限制）和 495（积分不足）
监控 Rate Limit 头
检查响应头中的 X-RateLimit-Remaining 了解剩余配额
实现重试机制
对于 429 错误，根据 Retry-After 头实现指数退避重试
优化提示词
清晰、具体的提示词能获得更好的生成结果
压缩图片
上传前压缩图片可以提高传输速度并节省带宽
API 速率限制
API 调用受到速率限制保护，限制因订阅计划而异：
年
年付费高级版
200 次/分钟
月
月付费高级版
20 次/分钟
💡响应头中会包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 信息