Tencent · 3D

HY-Motion API

Generate humanoid motion-capture animation from a text prompt (e.g. "walking", "sword attack", "dance") or a person video (model=gvhmr + videoUrl). Models: hy-motion (3 cr, default), kimodo-soma (3 cr), gvhmr (3 cr, video). Defaults: 3s duration, 60% intensity for text models. Returns motion JSON to retarget onto a rigged character (see model_rig). Async: returns a jobId — poll GET /api/v1/jobs/:id until it succeeds, then read result.animation.url.

Available through Sorceress API

Use with an AI agentManage API keys
HY-Motion model artwork

Using HY-Motion in your workflow

Sorceress brings Tencent models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

  • Create character motion using the selected motion model.
  • Inspect the model-specific inputs before choosing text-driven animation or motion reconstruction.

Pricing and availability

3 credits per model (hy-motion, kimodo-soma, gvhmr). Charged only on success.. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Inputs and supported options

promptstring · optional

Text description of the motion, e.g. "walking forward", "two-handed sword slash", "happy dance". Required for hy-motion / kimodo-soma; optional for gvhmr.

videoUrlstring · optional

Public HTTPS URL of a monocular person video. Required when model is "gvhmr".

modelstring · optional

Animation model: "hy-motion" (default, 3 credits), "kimodo-soma" (3 credits), or "gvhmr" (3 credits, video → animation).

durationSecondsnumber · optional

Clip length in seconds, 0.5–10. Default 3. Ignored for gvhmr (length follows the video).

intensitynumber · optional

Movement intensity percentage, 10–100. Default 60. Higher = larger, more energetic motion. Ignored for gvhmr.

seednumber · optional

Random seed for reproducible results. Default: random.

API request template

Replace placeholders and choose valid values from the input contract. 

POST /api/v1/tools/model_animate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{
  "model": "hy-motion"
}
Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.