Genjutsu

创建任务

POST https://api.nanoapi.ai/v1/genjutsu

读取源视频，从可用余额中冻结费用，返回 202 Accepted 和状态为 queued 的任务。视频在后台生成，通常需要 10–20 分钟，通过回调或 GET /v1/tasks/{id} 获取结果。任务不能取消。

读取源视频需要 1–3 秒，最长约 35 秒：客户端超时请设为 60 秒以上。

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",
    "metadata": { "order_id": "A1001" },
    "webhook_url": "https://example.com/hooks/nanoapi"
  }'

返回（节选，各字段见任务对象）：

{
  "object": "task",
  "id": "tk_01jb8z5q4w3e2r1t0y9u8i7o6p",
  "product": "genjutsu",
  "model": "genjutsu-1.0",
  "status": "queued",
  "billing": { "currency": "USD", "frozen": "4.095", "charged": "0.00", "refunded": "0.00", "billed_seconds": null },
  "metadata": { "order_id": "A1001" },
  "created_at": "2026-10-22T08:30:00Z"
}

素材

所有素材都以公开的 http(s) 链接提交。不提供上传接口，请自行托管文件，例如放在你自己的对象存储中。链接最长 4096 字符，不能指向 localhost 或内网、回环、保留地址。

任务结束前所有链接都要保持可访问，有有效期的链接也不能提前过期。

价格

费用 = 源视频的计费秒数 × 所选分辨率的每秒单价

计费秒数：

• 时长：取视频画面和音轨里较长的那个，不是文件信息里显示的时长。编码带来的几十毫秒误差不算在内（画面正好 30 秒、文件信息显示 30.02 秒的视频可以提交）。
• motion_control：四舍五入到整秒，不足 4 秒按 4 秒算。
• replace_object：向上取整到整秒。

例如 720p、15 秒的视频冻结 $4.095，成功后扣 $4.095。价格可能调整，请从 GET /v1/products 读取，不要写死在代码里。冻结和扣费的通用规则见计费规则。

想在提交前显示价格：在你这边读出视频时长，按上面的规则计算。这只是预估，以返回的 billing.frozen 为准。

错误

这个接口特有的错误。全部错误码和处理方式见错误。

以上错误都不会创建任务，也不会冻结费用。