Bỏ qua đến nội dung

Meshy Rigging Multi Animation

Tích hợp

Id mô hình meshy/rigging/multi-animation
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/rigging/multi-animation?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Các tệp như ví dụ: 0,44 $ 440 tín dụng API · ≈ 46,40 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Meshy 3D #stylized#transform#3d

Gắn khung xương một lần cho mô hình GLB hình người và kết hợp nhiều thiết lập sẵn hoạt ảnh trong một lần chạy

Meshy · Dữ liệu (JSON)

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

URL dùng để gắn xương và tạo hoạt ảnh cho nhân vật 3D hình người có các chi dễ phân biệt. URL phải có thể truy cập công khai và trỏ đến tệp GLB; mô hình có thể đến từ Hunyuan, Trellis, Meshy hoặc công cụ tạo sinh 3D khác.

•bắt buộc

Các ID hoạt ảnh preset trong thư viện Meshy; cần ít nhất một ID, mỗi ID nằm trong [0, 696], tối đa 10 clip khác nhau và loại bỏ ID trùng. Mỗi ID tạo một clip dùng cùng bộ xương, được trả về trong mảng animations theo thứ tự yêu cầu. Các ID khả dụng được mô tả tại https://docs.meshy.ai/en/api/animation-library.

Nâng cao height_meters · enable_safety_checker
mặc định 1.7

Chiều cao ước tính của nhân vật, tính bằng mét.

POST /run/meshy/rigging/multi-animation?wait=20 báo giá → 0,44 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/rigging/multi-animation?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Meshy Rigging Multi Animation

Gắn khung xương cho GLB hình người từ `model_url` và tạo một đoạn hoạt ảnh cho mỗi ID trong `animation_action_ids`, tất cả trên cùng một bộ khung xương. Các đoạn được trả về theo thứ tự yêu cầu trong mảng `animations`, cùng với các tệp GLB và FBX đã gắn khung xương cũng như hoạt ảnh đi bộ và chạy cơ bản. Cần ít nhất một ID. `height_meters` đặt chiều cao xấp xỉ của nhân vật.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
model_urlbắt buộc
Kiểustring
URL dùng để gắn xương và tạo hoạt ảnh cho nhân vật 3D hình người có các chi dễ phân biệt. URL phải có thể truy cập công khai và trỏ đến tệp GLB; mô hình có thể đến từ Hunyuan, Trellis, Meshy hoặc công cụ tạo sinh 3D khác.
height_meterstùy chọn
Kiểunumber
Mặc định1.7
> 0
Chiều cao ước tính của nhân vật, tính bằng mét.
animation_action_idsbắt buộc
Kiểuinteger[]
Các ID hoạt ảnh preset trong thư viện Meshy; cần ít nhất một ID, mỗi ID nằm trong [0, 696], tối đa 10 clip khác nhau và loại bỏ ID trùng. Mỗi ID tạo một clip dùng cùng bộ xương, được trả về trong mảng animations theo thứ tự yêu cầu. Các ID khả dụng được mô tả tại https://docs.meshy.ai/en/api/animation-library.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc kiểm tra an toàn trước xử lý: true khiến kiểm tra an toàn đầu vào là điều kiện bắt buộc trước khi xử lý.
bắt buộc

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/rigging/multi-animation",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 440,
    "usd": "0.44",
    "charged": 440,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  },
  "output": {
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "animations": [
      {
        "action_id": 1,
        "animation_glb": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "animation_fbx": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
rigged_character_glb
object {url, content_type, file_name, file_size} | nullNhân vật định dạng GLB đã được gắn xương.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullNhân vật định dạng FBX đã được gắn xương.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullHoạt ảnh đi bộ và chạy cơ bản được cung cấp cùng quá trình gắn xương.
animations
array of object {action_id, animation_glb, animation_fbx}Các kết quả hoạt ảnh theo thứ tự, tương ứng với các ID hành động trong yêu cầu. Mỗi ID được yêu cầu có một mục chứa clip được tạo bằng bộ xương.
rig_task_id
string | nullMã định danh tác vụ gắn xương trong Meshy.

Thêm mô hình: 3D

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/meshy/rigging/multi-animation.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt