开发者 API
通过 AutoRig HTTP API，可从链接或上传创建任务，轮询直到完成，然后通过固定 URL 下载已绑定的模型、动画文件及相关文件。这里的任务与网站上的 V3 任务完全相同，结果是带动画片段和导出功能的 V3 查看器。
基础 URL:
https://autorig.online
V3 中任务的工作方式
- 任务可从任意输入开始：3D 模型（GLB、FBX、OBJ，或带纹理的 ZIP）、图片、汽车图片或文字。下面的调用通过链接或上传创建任务，示例使用的是模型链接。
- V3 流水线会在几秒内根据几何体生成骨骼和蒙皮，并立即重定向动画片段。质量检查在后台运行。
- 结果是任务页面
https://autorig.online/task?id=TASK_ID：带动画片段和 AI 助手聊天的 V3 查看器。 - 查看器提供 GLB、FBX、USDZ、ZIP、Unity 包和 Blender 文件下载。下面的接口使用固定 URL，
cached-files会列出任务的所有文件及其下载 URL。
身份验证
在每个请求中使用 Authorization: Bearer <密钥> 或 X-API-Key: <密钥>。密钥格式为 ar_<前缀>_<密钥>。已登录用户或带浏览器会话 cookie 的访客可在本页或购买积分页创建密钥。
API 访问
生成 API 密钥，以便从外部工具调用 AutoRig REST API。
你的密钥
-
主要接口
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/task/create | multipart 表单：source=link、input_url、type=t_pose |
| GET | /api/task/{id} | 任务状态与元数据 |
| GET | /api/task/{id}/prepared.glb | 预览 / 预处理模型 GLB |
| GET | /api/task/{id}/animations.glb | 合并动画 GLB |
| GET | /api/task/{id}/animations.fbx | 动画 FBX（Unity 等） |
| GET | /api/task/{id}/model.glb | 基础模型 GLB |
| GET | /api/task/{id}/cached-files | 缓存文件列表与下载 URL 的 JSON |
典型流程
- 使用链接调用
POST /api/task/create（带input_url的 JSON，或带input_url或文件的 multipart）。 - 轮询
GET /api/task/{id}，直到状态为done或error。 - 调用
GET /api/task/{id}/cached-files获取文件列表。 - 用
GET下载prepared.glb、animations.glb、animations.fbx或model.glb。
示例
将 TASK_ID 与 YOUR_API_KEY 替换为实际值。使用链接输入时，模型 URL 需公开可访问。
curl -X POST "$BASE/api/task/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://example.com/model.glb"}'
curl -X POST "$BASE/api/task/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "input_url=https://example.com/model.glb"
curl -H "Authorization: Bearer YOUR_API_KEY" "$BASE/api/task/TASK_ID"
curl -o out.glb -H "Authorization: Bearer YOUR_API_KEY" "$BASE/api/task/TASK_ID/prepared.glb"U3D YouTube 提供方
U3D 上传使用专用的提供方密钥和独立的 OAuth 凭据，既不需要也不接受 AutoRig 管理员 API 密钥。打开提供方页面可查看现成的 curl 示例、实时就绪状态、仅管理员可用的密钥复制按钮以及智能体技能。