快速开始
NanoAPI 是异步的 AI 视频生成 API。创建 Key、提交任务、拿到视频。
你提交一个任务,NanoAPI 在后台生成视频(通常需要 10–20 分钟),结果通过回调推送或由你轮询获取。费用在创建任务时从预充值余额中冻结,任务成功时扣除,失败时全额退回。
https://api.nanoapi.ai/v1仅支持 HTTPS 和 JSON。API Key、充值和账单流水在控制台管理,不通过 API。
获取 API Key
在控制台 → API Keys 创建 Key。完整的 Key 只显示一次,请立即保存:
export NANOAPI_API_KEY="nf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"可用余额需要够付这次任务的费用(720p 下 15 秒的视频为 $4.095),在控制台充值。
创建任务
用公开链接提交一段源视频和一张参考图。示例用的是 Genjutsu 的动作迁移。
curl https://api.nanoapi.ai/v1/genjutsu \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "genjutsu-1.0",
"mode": "motion_control",
"image_urls": ["https://example.com/person.png"],
"video_url": "https://example.com/dance.mp4",
"resolution": "720p"
}'接口返回 202 Accepted 和状态为 queued 的任务,billing.frozen 是为它冻结的金额。
创建任务要先读取源视频,客户端超时请设为 60 秒以上。