Авториггинг 3D-моделей из кода

Быстрый старт#

От входа до модели с ригом — за три шага. Нужен Node.js 18.17 или новее.

1. 01

   Создайте ключ

   Войдите в свой аккаунт afk.ai через Google и создайте ключ в разделе «API-ключи». Он начинается с afk_ и показывается один раз; отозвать его там же можно в любой момент. Не размещайте его на веб-страницах и в приложениях, которые люди скачивают.

2. 02

   Добавьте его в окружение

   shellкопировать

   export AFK_API_KEY=afk_...   # from afk.ai/account#api

3. 03

   Сделайте риг модели

   clinode.jsclaude codemcp.jsonкопировать

   npx afk-rig knight.glb --type human -o knight.rigged.glb

   Риги выполняются на наших GPU, обычно за 1–2 минуты; CLI и клиент дожидаются результата. В MCP-клиенте попросите что-нибудь вроде «сделай риг models/fox.glb как четвероногого животного».

По картинке#

Ещё нет 3D-модели? Отправьте вместо неё картинку персонажа: один вызов создаст по ней текстурированную 3D-модель, затем сделает ей риг со всеми анимациями для её типа тела — в одном GLB, примерно за 2–3 мин.

25¢ за персонажа из ваших кредитов: 3D-модель, риг и все анимации; при неудаче деньги возвращаются. Бесплатные риги не распространяются на персонажей. Это видно в поле billing задачи: held, пока она выполняется, затем charged или refunded, а CLI выводит, сколько списано и сколько кредитов осталось.

npx afk-rig character knight.png -o knight.glb
# Done in 135 s: 593 animations, 15.2 MB, charged $0.25 from your API credits. $4.75 of credits left.

Лучше всего подходит чёткая, хорошо освещённая картинка одного персонажа целиком на однотонном фоне. Текстуры модели (цвет, металличность и шероховатость) создаются под стать картинке, а первый запрос после затишья может занять до 5 минут, пока запускается GPU. В MCP-клиенте попросите что-нибудь вроде «сделай персонажа с ригом из art/knight.png». Подробнее — в нашем руководстве по API для персонажа с ригом по картинке.

Типы тела#

Передайте один из них в --type. afk.ai подгоняет скелет, созданный для этого типа, рассчитывает веса скиннинга и добавляет все анимации, сделанные для этого скелета: всего 933 для всех типов. afk-rig types <type> выводит анимации типа.

humanклипов: 593

Люди, роботы, зомби, все, кто ходит на двух ногах. С пальцами.

foxклипов: 128

Собаки, кошки, лисы, волки

horseклипов: 22

Лошади, олени, коровы

birdклипов: 19

Крылья и две лапы

dragonклипов: 20

Крылья и четыре лапы

kaijuклипов: 18

Прямоходящие, с хвостом

spiderклипов: 18

Шесть или восемь ног, без крыльев

snakeклипов: 15

Без ног, один длинный позвоночник

fishклипов: 16

Рыбы, акулы, киты

CLI#

Запускайте через npx afk-rig или установите глобально командой npm i -g afk-rig. Прогресс выводится в stderr, а путь к записанному файлу — в stdout, так что CLI легко встраивается в скрипты.

Параметры

Коды выхода

Node.js#

Тот же пакет — это типизированный клиент: import { AfkRig } from 'afk-rig'. new AfkRig() читает AFK_API_KEY, или передайте { apiKey }.

По шагам

import { AfkRig } from 'afk-rig'

const afk = new AfkRig()

const started = await afk.startRig('fox.glb', { type: 'fox', facing: 'auto' })
// { id: 'rig_…', status: 'queued', billing: { charge: 'credits', state: 'held', … } }

const done = await afk.waitForRig(started.id, {
  onUpdate: (job) => console.log(job.status, job.stage), // rigging skeleton, rigging fit, …
})

const glb = await afk.downloadRig(done.id) // Uint8Array, for 24 hours

Ошибки — это AfkRigError с HTTP-статусом status, кодом code из таблицы ниже и, при превышении лимита запросов, retryAfter в секундах.

MCP-сервер#

npx -y afk-rig mcp запускает его как MCP-сервер на stdio, так что Claude Code, Cursor, Windsurf, Claude Desktop и другие MCP-клиенты могут делать риг моделей, которые они создают. Передайте ему AFK_API_KEY в окружении.

claude mcp add afk-rig -e AFK_API_KEY=afk_... -- npx -y afk-rig mcp

{
  "mcpServers": {
    "afk-rig": {
      "command": "npx",
      "args": ["-y", "afk-rig", "mcp"],
      "env": { "AFK_API_KEY": "afk_..." }
    }
  }
}

Инструменты

Жизненный цикл рига#

Риг — это асинхронная задача. Загрузите модель, и вы сразу получите её id; задача проходит через эти статусы, а CLI и клиент опрашивают её за вас.

billing.state равен held, пока выполняется платный риг, charged, когда файл готов, и refunded, если риг не удался, так что неудачный риг ничего не стоит. billing.charge показывает способ оплаты: free, rerig, credits или character. Персонаж по картинке находится в статусе generating (создаётся его 3D-модель), прежде чем перейти к риггингу. Готовая задача в том виде, в каком её выводит afk-rig status <id> --json:

{
  "id": "rig_Xq3v9KfL2mTz8RbA1cWd",
  "status": "succeeded",
  "stage": null,
  "type": "human",
  "file": "knight.glb",
  "animations": "all",
  "facing": null,
  "created_at": "2026-10-26T17:02:11Z",
  "finished_at": "2026-10-26T17:03:35Z",
  "billing": { "charge": "credits", "amount_usd": "0.05", "state": "charged" },
  "error": null,
  "result": {
    "download_url": "https://…/v1/rigs/rig_Xq3v9KfL2mTz8RbA1cWd/model.glb",
    "bytes": 7412032,
    "animations": 593,
    "expires_at": "2026-10-27T17:03:35Z"
  }
}

Ошибки#

Запросы, которые API отклоняет, возвращаются с HTTP-статусом и полем code; плата за них не берётся.

Когда риг не удаётся

Задача, которая была принята, но не смогла пройти риггинг, завершается со status: "failed" и одним из этих значений в error.code. Плата за неё не берётся.

Ограничения#

Цены#

5¢ за риг, фиксированно. Риг — это весь результат: скелет, веса скиннинга и все анимации для типа тела. Персонаж по картинке стоит 25¢. Никакой платы за каждую анимацию и никакой подписки.

Сколько стоит месяц

Сравнение с другими API риггинга#

Самая низкая цена с оплатой по факту среди всех API риггинга, которые мы нашли. Опубликованные цены API, с кредитами, переведёнными в доллары, по обычным планам каждого провайдера. Голый риг у Ludo.ai дешевле, если платить за год вперёд; гуманоид с десятью анимациями здесь стоит меньше, чем через любой другой API, который мы посчитали. Расчёты — в нашем сравнении цен на API авториггинга.

Цены проверены по собственным страницам каждого провайдера по состоянию на октябрь 2026 г., только обычные планы (без предложений для новых пользователей): Ludo.ai, Meshy API, Планы Meshy, Uthana, Tripo, Anything World, FAQ Mixamo. Они меняются; проверьте перед решением.

Вопросы и ответы#