API для разработчиков

HTTP API AutoRig создаёт задачи по ссылке или загрузке; опрашивайте статус до завершения, затем скачивайте зариганную модель, файлы анимаций и другие файлы по стабильным URL. Задача — та же V3-задача, что и на сайте, а её результат — вьювер V3 с клипами анимации и экспортом.

Базовый URL: https://autorig.online

Как работает задача в V3

Задача начинается с любого входа: 3D-модели (GLB, FBX, OBJ или ZIP с текстурами), картинки, картинки автомобиля или текста. Вызовы ниже создают задачу по ссылке или загрузке; в примерах используется ссылка на модель.
Конвейер V3 строит скелет и скин по геометрии за секунды и сразу переносит клипы анимации. Проверки качества идут в фоне.
Результат — страница задачи https://autorig.online/task?id=TASK_ID: вьювер V3 с клипами и чатом ИИ-агента.
Вьювер предлагает скачивание в GLB, FBX, USDZ, ZIP, пакетом Unity и файлом Blender. У эндпоинтов ниже стабильные URL, а cached-files перечисляет все файлы задачи с URL скачивания.

Аутентификация

Передавай секретный ключ в каждом запросе: заголовок Authorization: Bearer <ключ> или X-API-Key: <ключ>. Формат: ar_<prefix>_<secret>. Залогиненные и анонимные пользователи (с cookie сессии) могут создавать ключи на этой странице или в разделе покупки кредитов.

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 со списком файлов и URL скачивания

Типичный порядок работы

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. Для source=link нужен публичный URL к 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, живой статус готовности, кнопка копирования ключа только для админа и скилл агента.

Открыть U3D YouTube API skill.md для агента