Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Meshy / Meshy Motion

Meshy Motion Swift

Meshy Motion Swift generates standalone character motion from text. Swift exports BVH at 3 credits per task. Clips can be retargeted to rigged characters.

availableClosed weights3D motion generation
Official documentation (opens in a new tab)Reviewed 14 Oct 2026
13 of 27 specification fields collected
Text input limit400400
Maximum outputNot collectedAwaiting source review
Input billingSee ratesMeshy API · text to motion
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected
Maximum input tokens
Not collected
Maximum output
Not collected
Reasoning
Not collected
Tool calling
Not collected
Structured output
Not collected

API task JSON is not caller-defined structured model output.

Streaming
Not supportedSource for Streaming (opens in a new tab)

SSE streams task metadata only. Motion result fields remain empty until generation succeeds.

Batch processing
Not collected

Multi-view inputs and queued tasks do not establish a discounted batch API.

Fine-tuning
Not collected

No customer model-weight fine-tuning contract documented.

Knowledge cutoff
Not collected
Release date
Not collected

Original release date not established by a later API or research announcement.

Parameters
Not collected
Architecture
Not collected
Languages
Not collected
Context caching
Not collected

No documented cache controls or cache price.

Output duration
2–10 seconds, in 0.5-second stepsSource for Output duration (opens in a new tab)
Output transport
Signed motion_url after completion; motion_format and duration_ms describe the clip.Source for Output transport (opens in a new tab)
Data retention
Apply or download motion clips within the three-day retention window; Enterprise retention is contract-dependent.Source for Data retention (opens in a new tab)

General retention documentation permits indefinite Enterprise storage. Confirm the account contract.

Cancellation and task deletion
Pending deletion refunds credits. In-progress deletion returns 409 and generation continues. Terminal deletion adds no refund; task failures are refunded separately.Source for Cancellation and task deletion (opens in a new tab)
Required request fields
prompt and duration required; mode selects prime or swift and defaults to prime.Source for Required request fields (opens in a new tab)
Input moderation
Rejected prompts return 403. No bypass option documented.Source for Input moderation (opens in a new tab)
Usage metering
3 credits per motion task, independent of the supported clip duration.Source for Usage metering (opens in a new tab)

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

Meshy API · text to motion

Provider source (opens in a new tab)
API model ID
swift

Value for mode, not an ai_model field or immutable checkpoint.

Access
POST https://api.meshy.ai/openapi/v1/text-to-motion with Bearer API key, prompt, duration and mode=swift. The selector is a mode field, not ai_model. Poll GET /:id or status SSE; download the completed motion_url.
Regions
No verified processing region
Data retention
Apply or download motion clips within the three-day retention window; Enterprise retention is contract-dependent.Source for Data retention (opens in a new tab)

General retention documentation permits indefinite Enterprise storage. Confirm the account contract.

Request quotas
Account-wide: Pro/Premium/Ultra/Studio 20 requests/sec; queue limits 10/30/100/20 respectively. Enterprise 100 requests/sec and default queue 100, customizable. Web tasks share the queue.Source for Request quotas (opens in a new tab)
Cancellation and task deletion
Pending deletion refunds credits. In-progress deletion returns 409 and generation continues. Terminal deletion adds no refund; task failures are refunded separately.Source for Cancellation and task deletion (opens in a new tab)
Output transport
Signed motion_url after completion; motion_format and duration_ms describe the clip.Source for Output transport (opens in a new tab)
Output duration
2–10 seconds, in 0.5-second stepsSource for Output duration (opens in a new tab)
Streaming
Not supportedSource for Streaming (opens in a new tab)

SSE streams task metadata only. Motion result fields remain empty until generation succeeds.

Required request fields
prompt and duration required; mode selects prime or swift and defaults to prime.Source for Required request fields (opens in a new tab)
Input moderation
Rejected prompts return 403. No bypass option documented.Source for Input moderation (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 14 Oct 2026
CategoryUsageRateUnit
Motion generationSwift motion clip13 creditsrequest

Rate conditions

  1. One generation task, duration 2–10 seconds; no USD conversion verified.
Pricing source (opens in a new tab)

Data & enterprise terms

API output is deleted after three days for non-Enterprise customers. Enterprise defaults to indefinite output storage, configurable to 1–30 days or contract-specific terms. This is output retention, not a guarantee about logs or all customer data.

Read the service policy (opens in a new tab)

Meshy API · apply motion

Provider source (opens in a new tab)
API model ID
Not collected

No model selector: this operation applies an existing motion task to an existing rig.

Access
POST https://api.meshy.ai/openapi/v1/animations with Bearer key, rig_task_id and motion_task_id. This is a downstream application operation, not a separate generation model.
Regions
No verified processing region
Required request fields
Completed rig_task_id plus motion_task_id. Use exactly one of motion_task_id, action_id or action_ids.Source for Required request fields (opens in a new tab)
Input modalities
Rigged biped character, Completed motion taskSource for Input modalities (opens in a new tab)
Output modalities
Animated 3D characterSource for Output modalities (opens in a new tab)
Data retention
Source motion is snapshotted when applying it; later source expiry/deletion does not affect that task. Apply before the source expires.Source for Data retention (opens in a new tab)
Endpoint availability
Requires a biped rig; quadruped rigs are rejected for generated motion.Source for Endpoint availability (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 14 Oct 2026
CategoryUsageRateUnit
Motion applicationApply generated motion to a rig13 creditsrequest

Rate conditions

  1. Separate task after generation. Source clip must exist and the character must be a biped. Rigging, if needed, is additional.
Pricing source (opens in a new tab)

Data & enterprise terms

API output is deleted after three days for non-Enterprise customers. Enterprise defaults to indefinite output storage, configurable to 1–30 days or contract-specific terms. This is output retention, not a guarantee about logs or all customer data.

Read the service policy (opens in a new tab)

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

Meshy API · text to motion

swift
Not verified

No model-specific prompt-cache contract or discounted cache rate documented.

How it works
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Minimum reusable input
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Lifetime & refresh
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

How to enable it
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Usage fields
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Billing rules
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Limits & data boundaries
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

No verified cache rate for this endpoint. An empty rate is not a zero charge.

Caching reviewed 14 Oct 2026

Meshy API · apply motion

Not verified

No model-specific prompt-cache contract or discounted cache rate documented.

How it works
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Minimum reusable input
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Lifetime & refresh
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

How to enable it
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Usage fields
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Billing rules
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

Limits & data boundaries
Not collected

No model-specific prompt-cache contract or discounted cache rate documented.

No verified cache rate for this endpoint. An empty rate is not a zero charge.

Caching reviewed 14 Oct 2026

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

Qualified inference: the provider names two proprietary hosted motion models, exposes only mode selectors, and restricts deriving its service code. Reviewed official repositories do not expose corresponding weights. The exact checkpoint relationship and weight license are not publicly documented.

Classification evidence (opens in a new tab)

Lifecycle dates

Text to Motion API introduced21 Aug 2026Source (opens in a new tab)
Generated clips supported by the Animation API26 Aug 2026Source (opens in a new tab)

Sources reviewed