API توسعه‌دهندگان
با HTTP API سرویس AutoRig از روی لینک یا آپلود تسک بسازید، تا پایان کار وضعیت را بررسی کنید و سپس مدل ریگ‌شده، فایل‌های انیمیشن و فایل‌های مرتبط را از نشانی‌های پایدار دانلود کنید. تسک همان تسک V3 سایت است و نتیجه‌اش ویوئر V3 با کلیپ‌های انیمیشن و خروجی‌هاست.
نشانی پایه (Base URL):
https://autorig.online
تسک در V3 چطور کار می‌کند
- تسک از هر ورودی‌ای شروع می‌شود: مدل سه‌بعدی (GLB، FBX، OBJ یا ZIP همراه تکسچر)، تصویر، تصویر خودرو یا متن. فراخوانی‌های زیر تسک را از روی لینک یا آپلود می‌سازند؛ نمونه‌ها از لینک مدل استفاده می‌کنند.
- خط تولید V3 در چند ثانیه اسکلت و اسکین را از روی هندسه می‌سازد و کلیپ‌های انیمیشن را بلافاصله ریتارگت می‌کند. بررسی‌های کیفیت در پس‌زمینه اجرا می‌شوند.
- نتیجه صفحه تسک
https://autorig.online/task?id=TASK_IDاست: ویوئر V3 با کلیپ‌ها و چت عامل هوش مصنوعی. - ویوئر دانلود GLB، FBX، USDZ، ZIP، پکیج Unity و فایل Blender را ارائه می‌دهد. اندپوینت‌های زیر نشانی پایدار دارند و
cached-filesهمه فایل‌های تسک را با نشانی دانلودشان فهرست می‌کند.
احراز هویت
کلید محرمانه خود را در هر درخواست با یکی از این هدرها بفرستید: Authorization: Bearer <key> یا X-API-Key: <key>. کلیدها شکلی مانند ar_<prefix>_<secret> دارند. کاربران واردشده و بازدیدکنندگان ناشناس (با کوکی نشست مرورگر) می‌توانند از همین صفحه یا صفحه خرید کلید بسازند.
دسترسی API
یک کلید API بسازید تا REST API سرویس AutoRig را از ابزارهای دیگر فراخوانی کنید.
اندپوینت‌های اصلی
| متد | مسیر | توضیحات |
|---|---|---|
| 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 | فهرست JSON فایل‌های ذخیره‌شده و نشانی‌های دانلود |
روند معمول
POST /api/task/createبا یک لینک (JSON باinput_urlیا multipart باinput_urlیا فایل).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 را جایگزین کنید. برای ورودی از طریق لینک، از یک نشانی عمومی و در دسترس به فایل GLB/FBX/OBJ خود استفاده کنید.
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 جداگانه استفاده می‌کنند. کلید API ادمین AutoRig نه لازم است و نه پذیرفته می‌شود. صفحه ارائه‌دهنده را باز کنید: نمونه آماده curl، وضعیت زنده آمادگی، دکمه کپی کلید ویژه ادمین و مهارت (skill) عامل آنجاست.