ArkRoute — Visual AI Model Router
Generate images and videos using the best AI models from around the world. ArkRoute provides a unified API for accessing premium visual AI models from Chinese and American providers.
Available Models
Image Generation
- -
nano-banana-2 — Google Gemini 2.5 Flash, fast and cheap ($0.02/image) - INLINECODE1 — Google Gemini 2.5 Flash, basic mode
- INLINECODE2 — ByteDance, highest quality Chinese image model
- INLINECODE3 — ByteDance, fast and affordable
- INLINECODE4 — Google Gemini Flash optimized for images
- INLINECODE5 — Google Gemini 3 Pro with enhanced image quality
Video Generation
- -
seedance-1.5-pro — ByteDance, best video generation AI available - INLINECODE7 — ByteDance, fast video generation for quick results
Quick Start
Generate Image
CODEBLOCK0
Generate Video
CODEBLOCK1
Check Video Status
CODEBLOCK2
OpenClaw Integration
This skill can be accessed through OpenClaw using the MCP (Model Context Protocol) server:
As MCP Tool
CODEBLOCK3
Direct API Usage from OpenClaw
CODEBLOCK4
Model Capabilities
| Model | Type | Provider | Quality | Speed | Cost |
|---|
| INLINECODE8 | Image | Google Gemini | High | Fast | $0.02 |
| INLINECODE9 |
Image | Google Gemini | Good | Very Fast | $0.01 |
|
seedream-4.5 | Image | ByteDance | Excellent | Medium | $0.05 |
|
seedream-5.0-lite | Image | ByteDance | Good | Fast | $0.03 |
|
seedance-1.5-pro | Video | ByteDance | Excellent | Slow | $0.20 |
|
seedance-1.0-fast | Video | ByteDance | Good | Fast | $0.10 |
Size Options
Image Sizes
- -
1K — 1024x1024 (square) - INLINECODE15 — 2048x2048 (square) — Recommended
- INLINECODE16 — 4096x4096 (square, premium)
- INLINECODE17 — 1:1 aspect ratio
- INLINECODE18 — 3:4 aspect ratio (vertical)
- INLINECODE19 — 4:3 aspect ratio (horizontal)
Video Aspect Ratios
- -
16:9 — Landscape (YouTube, most screens) - INLINECODE21 — Portrait (TikTok, Instagram Stories)
- INLINECODE22 — Square (Instagram posts)
Getting an API Key
- 1. Visit https://ark-route.com
- Sign up for a free account
- Get 100 free credits to start generating
- Upgrade for higher limits and premium models
Error Handling
Common Error Codes
- -
401 — Invalid API key - INLINECODE24 — Insufficient credits
- INLINECODE25 — Rate limit exceeded
- INLINECODE26 — Model provider error
Best Practices
- - Always check the response status before processing results
- Implement retry logic for transient errors (429, 500)
- Monitor your credit balance through the dashboard
- Use appropriate timeouts for video generation (can take 30+ seconds)
Advanced Features
Image-to-Image Generation
CODEBLOCK5
Image-to-Video Generation
CODEBLOCK6
Support
- - Documentation: https://docs.ark-route.com
- API Status: https://status.ark-route.com
- Discord Community: https://discord.gg/arkroute
ArkRoute is designed for developers and creators who need reliable access to the world's best visual AI models through a simple, unified API.
ArkRoute — 视觉AI模型路由器
使用来自全球的最佳AI模型生成图像和视频。ArkRoute提供统一API，可访问中美供应商的优质视觉AI模型。
可用模型
图像生成
- - nano-banana-2 — Google Gemini 2.5 Flash，快速且便宜（$0.02/张）
- nano-banana-basic — Google Gemini 2.5 Flash，基础模式
- seedream-4.5 — 字节跳动，最高质量的中文图像模型
- seedream-5.0-lite — 字节跳动，快速且经济实惠
- gemini-flash-image — Google Gemini Flash，针对图像优化
- gemini-3-pro-image — Google Gemini 3 Pro，增强图像质量
视频生成
- - seedance-1.5-pro — 字节跳动，目前最佳视频生成AI
- seedance-1.0-fast — 字节跳动，快速视频生成，即时出结果
快速开始
生成图像
bash
curl -X POST https://api.ark-route.com/v1/images/generations \
-H Authorization: Bearer YOUR
APIKEY \
-H Content-Type: application/json \
-d {
model: nano-banana-2,
prompt: 一座宁静的日式花园，樱花盛开,
size: 2K
}
生成视频
bash
curl -X POST https://api.ark-route.com/v1/videos/generations \
-H Authorization: Bearer YOUR
APIKEY \
-H Content-Type: application/json \
-d {
model: seedance-1.5-pro,
prompt: 云层在山脉上空移动的延时摄影,
duration: 5,
aspect_ratio: 16:9
}
检查视频状态
bash
curl -X GET https://api.ark-route.com/v1/videos/TASK_ID \
-H Authorization: Bearer YOUR
APIKEY
OpenClaw集成
此技能可通过OpenClaw使用MCP（模型上下文协议）服务器访问：
作为MCP工具
python
MCP服务器暴露以下工具：
- generateimage(prompt, model=nano-banana-2, size=2K, referenceimage=None)
- generatevideo(prompt, model=seedance-1.5-pro, duration=5, aspectratio=16:9)
- checkvideostatus(task_id)
- list_models()
启动MCP服务器
python3 /path/to/arkroute/mcp_server.py
从OpenClaw直接使用API
python
import requests
生成图像
response = requests.post(
https://api.ark-route.com/v1/images/generations,
headers={
Authorization: Bearer YOUR
APIKEY,
Content-Type: application/json
},
json={
model: nano-banana-2,
prompt: 日落时分的未来城市景观,
size: 2K
}
)
result = response.json()
print(f图像URL: {result[data][0][url]})
模型能力
| 模型 | 类型 | 供应商 | 质量 | 速度 | 成本 |
|---|
| nano-banana-2 | 图像 | Google Gemini | 高 | 快 | $0.02 |
| nano-banana-basic |
图像 | Google Gemini | 好 | 非常快 | $0.01 |
| seedream-4.5 | 图像 | 字节跳动 | 优秀 | 中等 | $0.05 |
| seedream-5.0-lite | 图像 | 字节跳动 | 好 | 快 | $0.03 |
| seedance-1.5-pro | 视频 | 字节跳动 | 优秀 | 慢 | $0.20 |
| seedance-1.0-fast | 视频 | 字节跳动 | 好 | 快 | $0.10 |
尺寸选项
图像尺寸
- - 1K — 1024x1024（正方形）
- 2K — 2048x2048（正方形）— 推荐
- 4K — 4096x4096（正方形，高级）
- square — 1:1 宽高比
- portrait — 3:4 宽高比（竖屏）
- landscape — 4:3 宽高比（横屏）
视频宽高比
- - 16:9 — 横屏（YouTube，大多数屏幕）
- 9:16 — 竖屏（TikTok，Instagram故事）
- 1:1 — 正方形（Instagram帖子）
获取API密钥
- 1. 访问 https://ark-route.com
- 注册免费账户
- 获得100个免费积分开始生成
- 升级以获得更高限额和高级模型
错误处理
常见错误代码
- - 401 — API密钥无效
- 402 — 积分不足
- 429 — 超过速率限制
- 500 — 模型供应商错误
最佳实践
- - 在处理结果前始终检查响应状态
- 对临时错误（429, 500）实施重试逻辑
- 通过仪表盘监控积分余额
- 为视频生成设置适当的超时时间（可能需要30秒以上）
高级功能
图像到图像生成
bash
curl -X POST https://api.ark-route.com/v1/images/generations \
-H Authorization: Bearer YOUR
APIKEY \
-H Content-Type: application/json \
-d {
model: seedream-4.5,
prompt: 将此转换为赛博朋克场景,
reference_image: https://example.com/input.jpg
}
图像到视频生成
bash
curl -X POST https://api.ark-route.com/v1/videos/generations \
-H Authorization: Bearer YOUR
APIKEY \
-H Content-Type: application/json \
-d {
model: seedance-1.5-pro,
prompt: 以轻柔的动作动画化此场景,
image_url: https://example.com/scene.jpg,
duration: 10
}
支持
- - 文档: https://docs.ark-route.com
- API状态: https://status.ark-route.com
- Discord社区: https://discord.gg/arkroute
ArkRoute专为需要通过简单统一API可靠访问全球最佳视觉AI模型的开发者和创作者而设计。
