애니메이션 API

리깅된 캐릭터에 애니메이션을 적용하고, 적용 가능한 애니메이션 목록을 확인하세요.

POST/openapi/v1/animations

애니메이션 작업 생성

이전에 리깅한 캐릭터에 애니메이션을 적용하는 애니메이션 작업을 생성합니다. 애니메이션은 다음 중 하나일 수 있습니다:

애니메이션 라이브러리의 프리셋 액션(action_id)
하나의 파일로 병합된 여러 개의 프리셋 액션(action_ids)
Text to Motion API로 생성한 모션 클립(motion_task_id)

출력을 후처리할 수도 있습니다. 작업은 백그라운드에서 실행됩니다. 작업이 보통 얼마나 걸리는지는 처리 시간을 참조하세요.

Request

POST

/openapi/v1/animations

# Animate a rigged model with required params only
curl https://api.meshy.ai/openapi/v1/animations \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "rig_task_id": "018b314a-a1b5-716d-c222-2f1776f7f579",
    "action_id": 92
  }'

# Apply several preset actions and get one file with one clip per action
curl https://api.meshy.ai/openapi/v1/animations \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "rig_task_id": "018b314a-a1b5-716d-c222-2f1776f7f579",
    "action_ids": [10, 25, 92]
  }'

# Apply a generated Text to Motion clip instead of a preset action
curl https://api.meshy.ai/openapi/v1/animations \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "rig_task_id": "018b314a-a1b5-716d-c222-2f1776f7f579",
    "motion_task_id": "018c425b-b2c6-727e-d333-3c1887i9h791"
  }'

# With post-processing to change FPS
curl https://api.meshy.ai/openapi/v1/animations \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "rig_task_id": "018b314a-a1b5-716d-c222-2f1776f7f579",
    "action_id": 92,
    "post_process": {
      "operation_type": "change_fps",
      "fps": 24
    }
  }'

Response

{
  "result": "018c425b-b2c6-727e-d333-3c1887i9h791"
}

파라미터

Name
rig_task_id
Type
string
필수
Description
애니메이션을 적용할 캐릭터가 있는 리깅 작업의 ID로, POST /openapi/v1/rigging에서 가져옵니다. 해당 작업의 상태는 SUCCEEDED여야 합니다.

action_id, action_ids, motion_task_id 중 정확히 하나를 보내야 합니다.

Name
action_id
Type
integer
필수
Description
action_ids 또는 motion_task_id를 보내지 않는 한 필수입니다. 적용할 프리셋 애니메이션의 ID입니다. 전체 애니메이션 목록은 애니메이션 라이브러리 레퍼런스 또는 애니메이션 목록 조회를 참조하세요.

Name
action_ids
Type
array of integers
필수
Description
action_id 또는 motion_task_id를 보내지 않는 한 필수입니다. 한 번에 적용할 1개에서 10개의 프리셋 애니메이션 ID로, 중복 없이 지정합니다. 10개를 초과하거나 ID가 중복되면 400을 반환합니다. ID 목록은 애니메이션 라이브러리 레퍼런스를 참조하세요.
Meshy는 액션별로 하나의 애니메이션 클립을 담은 파일 하나를 반환하며, 이는 게임 엔진의 상태 머신에 적합합니다. Meshy는 목록에 있는 각 액션에 대해 요금을 부과합니다. 요금을 참조하세요.
ID 하나로 된 목록은 해당 ID를 action_id로 보낸 것과 동일하게 동작합니다.

Name
motion_task_id
Type
string
필수
Description
action_id 또는 action_ids를 보내지 않는 한 필수입니다. 프리셋 액션 대신 적용할 클립이 있는 Text to Motion 작업의 ID입니다. 해당 작업의 상태는 SUCCEEDED여야 하며, 리그는 2족 보행(biped)이어야 합니다.
Meshy는 리깅된 캐릭터에 클립을 리타깃합니다. 이 작업을 생성할 때 클립을 복사하므로, 이후 Text to Motion 작업이 만료되거나 삭제되더라도 이 작업에는 영향이 없습니다. Meshy는 Text to Motion 작업의 파일을 3일간 보관하므로, 그 전에 클립을 적용하세요.

Name
post_process
Type
object
Description
애니메이션 출력물에 대한 후처리입니다. 표준 애니메이션 파일을 받으려면 생략하세요.
motion_task_id를 사용하면 리타깃 결과가 GLB 전용 애니메이션으로 생성될 수 있습니다. post_process를 보냈는데 FBX 파일을 사용할 수 없는 경우, 작업은 task_error로 실패하며 Meshy가 크레딧을 환불합니다. post_process가 없으면 작업은 성공하고 animation_fbx_url은 비어 있습니다.

다음 경우에만 적용 post_process is set

Name
operation_type
Type
string
Description
실행할 작업입니다. 지정하지 않으면 Meshy는 추가 파일을 만들지 않습니다. 다음 목록에 없는 값을 보내면 400을 반환합니다.
사용 가능한 값:
- change_fps: 프레임 레이트를 fps로 변경합니다
- fbx2usdz: 애니메이션을 USDZ로 변환합니다
- extract_armature: 아마추어를 FBX 파일로 추출합니다
Name
fps
Type
integer
기본값 30
Description
변경할 프레임 레이트로, 24, 25, 30, 60 중 하나입니다. operation_type이 change_fps일 때만 적용됩니다. 다른 값을 보내면 400을 반환합니다.

action_ids를 사용하면 작업은 액션별로 파일 하나씩이 아니라 하나의 병합된 파일을 반환합니다. animation_glb_url과 animation_fbx_url은 각각 요청된 모든 액션을 개별 클립으로 담은 파일 하나를 가리킵니다. 해당 파일에서:

클립 순서: ID의 숫자 순서가 아니라 action_ids 배열의 순서를 따릅니다.
클립 이름: 라이브러리에 있는 애니메이션의 이름입니다. 이는 Meshy 웹 앱에서 캐릭터의 모든 애니메이션을 하나의 파일로 내보낼 때 얻는 이름과 일치합니다. 요청된 두 ID의 클립 이름이 같으면, Meshy는 이름을 고유하게 유지하기 위해 나중 항목에 action_id를 추가합니다.
후처리: Meshy는 각 클립이 아니라 병합된 파일에 후처리를 적용합니다.

반환값

응답의 result 필드에는 새로 생성된 애니메이션 작업의 ID가 담겨 있습니다.

실패 모드

Name
400 - Bad Request
Description
요청을 실행할 수 없습니다. 오류 메시지에 발견된 문제가 표시됩니다. 예를 들어:
- 파라미터 누락: rig_task_id가 누락되었거나, action_id, action_ids, motion_task_id 중 어느 것도 보내지 않았습니다.
- 파라미터 충돌: 요청에 action_id, action_ids, motion_task_id 중 두 개 이상이 포함되어 있습니다. 하나만 보내세요.
- 유효하지 않은 리깅 작업: rig_task_id가 유효한 작업 ID가 아니거나, 리깅 작업이 아니거나, 성공하지 않은 작업을 가리킵니다.
- 유효하지 않은 액션 ID: action_id 또는 action_ids의 항목이 유효한 애니메이션이 아닙니다.
- 액션 개수 초과: action_ids에 10개를 초과하는 ID가 있습니다.
- 중복 액션: action_ids에 동일한 ID가 두 번 이상 있습니다.
- 모션 작업 준비되지 않음: motion_task_id 작업이 아직 SUCCEEDED에 도달하지 않았습니다.
- 지원되지 않는 리그: motion_task_id는 2족 보행 리그가 필요하며, Meshy는 4족 보행 리그를 거부합니다.
요청을 수정한 뒤 다시 보내세요. 오류를 참조하세요.
Name
401 - Unauthorized
Description
API 키가 없거나 유효하지 않습니다. Authorization 헤더를 확인하세요.
Name
402 - Payment Required
Description
예를 들어:
- 크레딧 부족: 계정에 이 작업을 수행할 만큼 충분한 크레딧이 없거나, 계정이 크레딧 한도에 도달했습니다. 크레딧 잔액을 확인한 뒤 다시 시도하세요.
- 무료 플랜: 작업을 생성하려면 유료 플랜이 필요합니다. 구독 설정에서 플랜을 업그레이드한 뒤 다시 시도하세요.
Name
403 - Forbidden
Description
rig_task_id 작업이 부조(bas-relief) 모델이며, 이 엔드포인트는 이를 애니메이션화할 수 없습니다. 메시지는 This model type does not support this operation입니다. 다른 모델을 리깅하세요.
Name
404 - Not Found
Description
Meshy가 요청에 필요한 작업이나 파일을 찾을 수 없습니다. 다음 중 하나에 해당합니다:
- Meshy가 사용자의 작업 중에서 rig_task_id 작업을 찾을 수 없습니다. ID를 확인하세요.
- Meshy가 rig_task_id 작업의 expires_at 이후 해당 파일을 삭제했습니다. 캐릭터를 다시 리깅하세요.
- Meshy가 motion_task_id 작업을 찾을 수 없습니다. ID를 확인하세요.
- Meshy는 Text to Motion 작업의 파일을 3일간만 보관하므로 모션 클립이 만료되었습니다. 다른 Text to Motion 작업을 생성하세요.
Name
429 - Too Many Requests
Description
속도 제한을 초과했습니다. 잠시 기다렸다가 다시 시도하세요. 속도 제한을 참조하세요.

GET/openapi/v1/animations/:id

Get an Animation task

ID로 Animation 작업을 반환합니다.

Request

GET

/openapi/v1/animations/018c425b-b2c6-727e-d333-3c1887i9h791

curl https://api.meshy.ai/openapi/v1/animations/018c425b-b2c6-727e-d333-3c1887i9h791 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018c425b-b2c6-727e-d333-3c1887i9h791",
  "type": "animate",
  "status": "SUCCEEDED",
  "created_at": 1747032440896,
  "progress": 100,
  "started_at": 1747032441210,
  "finished_at": 1747032457530,
  "expires_at": 1747291657530,
  "task_error": null,
  "consumed_credits": 3,
  "result": {
    "animation_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018c425b-b2c6-727e-d333-3c1887i9h791/output/Animation_Reaping_Swing_withSkin.glb?Expires=...",
    "animation_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018c425b-b2c6-727e-d333-3c1887i9h791/output/Animation_Reaping_Swing_withSkin.fbx?Expires=...",
    "processed_usdz_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018c425b-b2c6-727e-d333-3c1887i9h791/output/processed.usdz?Expires=...",
    "processed_armature_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018c425b-b2c6-727e-d333-3c1887i9h791/output/processed_armature.fbx?Expires=...",
    "processed_animation_fps_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018c425b-b2c6-727e-d333-3c1887i9h791/output/processed_60fps.fbx?Expires=..."
  }
}

매개변수

Name
id
Type
path
Description
생성 응답에서 받은 작업 ID입니다.

반환값

Animation 작업 객체를 반환합니다.

DELETE/openapi/v1/animations/:id

애니메이션 작업 삭제

애니메이션 작업을 모델 및 데이터와 함께 영구적으로 삭제합니다. 삭제는 취소할 수 없습니다.

Request

DELETE

/openapi/v1/animations/018b314a-a1b5-716d-c222-2f1776f7f579

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/animations/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

경로 매개변수

Name
id
Type
path
Description
삭제할 작업의 ID입니다.

작업 상태

PENDING 상태의 작업을 삭제하면 생성 시 사용된 크레딧이 환불됩니다.

IN_PROGRESS 상태의 작업은 삭제할 수 없습니다. 요청은 409 Conflict를 반환하며, 작업은 계속 실행됩니다. Meshy는 이미 시작된 작업에 대해서는 환불하지 않으므로, 이를 삭제하면 크레딧과 결과물을 모두 잃게 됩니다. 작업이 SUCCEEDED, FAILED, 또는 CANCELED 상태에 도달할 때까지 기다린 후 삭제하세요.

최종 상태(SUCCEEDED, FAILED, 또는 CANCELED)의 작업을 삭제해도 해당 크레딧은 환불되지 않습니다.

반환값

작업이 삭제되면 200 OK를, 작업이 IN_PROGRESS 상태이면 409 Conflict를 반환합니다.

GET/openapi/v1/animations

애니메이션 작업 목록 조회

최신순으로 정렬된 애니메이션 작업의 페이지네이션 목록을 반환합니다. 목록을 페이지별로 탐색하려면 page_num과 page_size를 사용하세요.

API를 통해 생성한 작업은 웹 앱의 My Assets에 표시되지 않으므로 API를 통해 관리해야 합니다. 더 이상 ID를 가지고 있지 않은 작업을 찾으려면 이 엔드포인트를 사용하세요.

Request

GET

/openapi/v1/animations

curl "https://api.meshy.ai/openapi/v1/animations?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/animations/:id/stream

애니메이션 작업 스트리밍

애니메이션 작업의 업데이트를 서버-전송 이벤트(SSE)로 스트리밍합니다.

Request

GET

/openapi/v1/animations/018c425b-b2c6-727e-d333-3c1887i9h791/stream

curl -N https://api.meshy.ai/openapi/v1/animations/018c425b-b2c6-727e-d333-3c1887i9h791/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018c425b-b2c6-727e-d333-3c1887i9h791",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018c425b-b2c6-727e-d333-3c1887i9h791",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: { // Example of a SUCCEEDED task stream item, with the same structure as the Animation task object
  "id": "018c425b-b2c6-727e-d333-3c1887i9h791",
  "type": "animate",
  "status": "SUCCEEDED",
  "created_at": 1747032440896,
  "progress": 100,
  "started_at": 1747032441210,
  "finished_at": 1747032457530,
  "expires_at": 1747291657530,
  "task_error": null,
  "consumed_credits": 3,
  "result": {
    "animation_glb_url": "https://assets.meshy.ai/.../Animation_Reaping_Swing_withSkin.glb?...",
    "animation_fbx_url": "https://assets.meshy.ai/.../Animation_Reaping_Swing_withSkin.fbx?...",
    "processed_usdz_url": "https://assets.meshy.ai/.../processed.usdz?...",
    "processed_armature_fbx_url": "https://assets.meshy.ai/.../processed_armature.fbx?...",
    "processed_animation_fps_fbx_url": "https://assets.meshy.ai/.../processed_60fps.fbx?..."
  }
}

매개변수

Name
id
Type
path
Description
생성 응답에서 얻은 작업 ID입니다.

반환값

애니메이션 작업 객체의 스트림을 서버-전송 이벤트로 반환합니다.

각 이벤트는 Get 엔드포인트가 반환하는 것과 동일한 형태로 전체 작업 객체를 담고 있습니다. 작업이 PENDING 또는 IN_PROGRESS 상태인 동안에는 결과 필드에 아직 값이 없습니다.

애니메이션 작업 객체

애니메이션 작업 객체는 리깅된 캐릭터에 적용된 하나의 애니메이션을 설명합니다. 이 객체는 상태, progress, 그리고 작업이 성공했을 때의 애니메이션 파일을 담고 있습니다.

속성

Example Animation Task Object

{
  "id": "018c425b-b2c6-727e-d333-3c1887i9h791",
  "type": "animate",
  "status": "SUCCEEDED",
  "created_at": 1747032440896,
  "progress": 100,
  "started_at": 1747032441210,
  "finished_at": 1747032457530,
  "expires_at": 1747291657530,
  "task_error": null,
  "consumed_credits": 3,
  "result": {
    "animation_glb_url": "https://assets.meshy.ai/.../Animation_Reaping_Swing_withSkin.glb?...",
    "animation_fbx_url": "https://assets.meshy.ai/.../Animation_Reaping_Swing_withSkin.fbx?...",
    "processed_usdz_url": "https://assets.meshy.ai/.../processed.usdz?...",
    "processed_armature_fbx_url": "https://assets.meshy.ai/.../processed_armature.fbx?...",
    "processed_animation_fps_fbx_url": "https://assets.meshy.ai/.../processed_60fps.fbx?..."
  }
}

Name
id
Type
string
Description
작업 ID입니다. 불투명한 문자열로 취급하고, 그 형식에 의존하지 마세요.
Name
type
Type
string
Description
작업 유형이며, 항상 animate입니다.
Name
status
Type
string
Description
작업 상태로, PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
progress
Type
integer
Description
작업이 얼마나 완료되었는지를 백분율로 나타냅니다. 작업이 시작되기 전까지는 0이고, 성공하면 100이 됩니다.
Name
created_at
Type
timestamp
Description
작업이 생성된 시간으로, 유닉스 밀리초 단위입니다.
Name
started_at
Type
timestamp
Description
작업이 시작된 시간으로, 유닉스 밀리초 단위입니다. 작업이 시작되기 전까지는 0입니다.
Name
finished_at
Type
timestamp
Description
작업이 종료된 시간으로, 유닉스 밀리초 단위입니다. 작업이 종료되기 전까지는 0입니다.
Name
expires_at
Type
timestamp
Description
작업의 결과 파일이 만료되는 시간으로, 유닉스 밀리초 단위입니다.
Name
task_error
Type
object
Description
작업이 실패했을 때의 오류 세부 정보입니다. 상태가 FAILED가 아니면 null입니다. 오류를 참고하세요.
Name
consumed_credits
Type
integer
Description
작업에 사용된 크레딧 수입니다. 상태가 PENDING, IN_PROGRESS, SUCCEEDED일 때 존재합니다. FAILED 작업의 경우 Meshy가 작업 실패 시 크레딧을 환불하므로 0입니다.
Name
result
Type
object
Description
작업 상태가 SUCCEEDED일 때, 애니메이션 파일의 다운로드 URL입니다.
- Name
  animation_glb_url
  Type
  string
  Description
  GLB 파일 형식의 애니메이션입니다. action_ids로 생성된 작업의 경우, 이 하나의 파일에 요청된 모든 동작이 각각 별도의 클립으로 담겨 있습니다.
- Name
  animation_fbx_url
  Type
  string
  Description
  FBX 파일 형식의 애니메이션입니다. action_ids로 생성된 작업의 경우, 이 하나의 파일에 요청된 모든 동작이 각각 별도의 클립으로 담겨 있습니다.
- Name
  processed_usdz_url
  Type
  string
  Description
  USDZ 파일 형식으로 처리된 애니메이션입니다.
- Name
  processed_armature_fbx_url
  Type
  string
  Description
  FBX 파일 형식으로 처리된 아마추어입니다.
- Name
  processed_animation_fps_fbx_url
  Type
  string
  Description
  예를 들어 change_fps 작업을 사용한 경우처럼, 프레임 레이트가 변경된 애니메이션을 FBX 파일 형식으로 제공합니다.
Name
preceding_tasks
Type
integer
Description
대기열에서 이 작업보다 앞에 있는 작업의 수입니다. 이 값은 작업이 PENDING 상태일 때만 의미가 있습니다. 값이 0일 때는 이 필드가 생략됩니다.

GET/openapi/v1/animations/library

애니메이션 목록 조회

라이브러리에 있는 모든 애니메이션을 action_id 순서로 반환합니다. 응답은 페이지 구분 없이 전체 목록을 제공하므로, 한 번의 호출로 액션 선택기를 채울 수 있습니다. 필터는 결과를 좁혀줍니다. 모든 애니메이션을 가져오려면 필터를 전부 생략하세요.

각 액션의 애니메이션 미리보기와 함께 동일한 목록을 둘러보려면 애니메이션 라이브러리 레퍼런스를 참고하세요.

이 요청은 크레딧을 소모하지 않습니다.

Request

GET

/openapi/v1/animations/library

curl "https://api.meshy.ai/openapi/v1/animations/library?category=Fighting" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "action_id": 4,
    "name": "Attack",
    "key": "Attack",
    "category": "Fighting",
    "sub_category": "AttackingwithWeapon",
    "preview_url": "https://cdn.meshy.ai/webapp-assets/feature-demo/animation/preview/biped/Attack.gif"
  },
  {
    "action_id": 92,
    "name": "Double Combo Attack",
    "key": "Double_Combo_Attack",
    "category": "Fighting",
    "sub_category": "AttackingwithWeapon",
    "preview_url": "https://cdn.meshy.ai/webapp-assets/feature-demo/animation/preview/biped/Double_Combo_Attack.gif"
  }
]

매개변수

Name
search
Type
string
Description
검색할 텍스트입니다. Meshy는 name 또는 key에 이 텍스트가 포함된 애니메이션을 대소문자 구분 없이 반환합니다. Meshy는 텍스트를 그대로 일치시키므로 %와 _는 와일드카드로 동작하지 않습니다.
Name
category
Type
string
Description
조회할 카테고리이며, 정확히 일치해야 합니다. 알 수 없는 카테고리는 빈 목록을 반환합니다.
사용 가능한 값:
- WalkAndRun
- BodyMovements
- DailyActions
- Fighting
- Dancing
Name
sub_category
Type
string
Description
조회할 하위 카테고리이며, 정확히 일치해야 합니다. category 없이도 보낼 수 있습니다. 하위 카테고리 이름은 카테고리 간에 고유하지 않습니다. 예를 들어 Transitioning은 Fighting과 DailyActions 양쪽 모두에 속해 있습니다. 따라서 category 없이 사용하면 필터는 모든 카테고리에서 해당 하위 카테고리와 일치합니다.
Name
action_ids
Type
string
Description
반환할 애니메이션을 쉼표로 구분된 최대 200개의 action_id 값으로 지정합니다. 전체를 둘러보는 대신 특정 ID를 조회할 때 사용하세요. 200개를 초과하면 400이 반환됩니다.
응답에는 해당하는 애니메이션이 없는 ID는 포함되지 않습니다. 따라서 이 필터를 사용해 저장해 둔 ID가 여전히 사용 가능한지 확인할 수도 있습니다.

필터 조합하기

Meshy는 필터들을 함께 적용합니다. 각 필터는 결과를 좁히므로, Meshy는 모든 필터와 일치하는 경우에만 애니메이션을 반환합니다. 하나의 필터 내에서는 그 값들 중 어느 하나라도 일치하면 됩니다. 예를 들어 search는 name 또는 key와 일치하고, action_ids는 목록에 있는 어떤 ID와도 일치할 수 있습니다.

따라서 겹치는 부분이 없는 조합은 오류가 아니라 빈 배열을 반환합니다. 액션 92는 "Double Combo Attack"으로, Fighting 애니메이션입니다. 예를 들어:

?action_ids=92&category=Fighting은 액션 92를 반환합니다.
?action_ids=92&category=Dancing은 []를 반환하는데, 이는 Dancing 애니메이션이 아니기 때문입니다.
?action_ids=92&search=walk는 []를 반환하는데, 이름이 walk와 일치하지 않기 때문입니다.

카테고리에 상관없이 특정 애니메이션을 가져오려면 action_ids만 단독으로 보내세요.

반환값

애니메이션 객체 목록입니다.

애니메이션 작업 생성하기는 이 엔드포인트가 반환하는 모든 action_id를 받아들이며, 이 엔드포인트는 생성 시 받아들여지는 모든 ID를 반환합니다. 둘 다 더 이상 사용되지 않는(retired) 애니메이션은 포함하지 않습니다. 라이브러리를 캐시하는 경우, 더 이상 사용되지 않는 ID가 선택기에 남아 있지 않도록 주기적으로 갱신하세요.

애니메이션 객체

애니메이션 객체는 라이브러리 내의 하나의 애니메이션을 설명합니다.

Example Animation Object

{
  "action_id": 92,
  "name": "Double Combo Attack",
  "key": "Double_Combo_Attack",
  "category": "Fighting",
  "sub_category": "AttackingwithWeapon",
  "preview_url": "https://cdn.meshy.ai/webapp-assets/feature-demo/animation/preview/biped/Double_Combo_Attack.gif"
}

Name
action_id
Type
integer
Description
Animation 작업을 생성할 때 action_id로 전송할 값입니다. 이 값은 고유하고 안정적이지만 연속적이지는 않습니다. 더 이상 사용되지 않는 애니메이션은 번호 체계에 빈 공간을 남기므로, 특정 범위 내의 모든 ID가 유효하다고 가정하지 마세요.
Name
name
Type
string
Description
애니메이션의 표시 이름입니다. 일부 애니메이션은 다른 변형과 이름을 공유하므로 고유하지 않습니다. 애니메이션을 식별하려면 action_id 또는 key를 사용하세요.
Name
key
Type
string
Description
애니메이션에 대한 고유하고 안정적인 슬러그입니다. 자체 저장소의 키로 사용할 숫자가 아닌 ID가 필요할 때 사용하세요.
Name
category
Type
string
Description
최상위 그룹으로, 예를 들어 Fighting입니다.
Name
sub_category
Type
string
Description
카테고리 내의 그룹으로, 예를 들어 AttackingwithWeapon입니다.
Name
preview_url
Type
string
Description
해당 동작의 애니메이션 GIF 미리보기 URL입니다. 이를 사용해 직접 만든 선택기에 바로 표시할 수 있습니다.