GET /api/health
Returns a lightweight health payload for discovery and uptime checks.
- Use this for status link relations and simple liveness probes.
- The response is intentionally stable and machine-readable.
Agent Discovery
NoCapMocap API documentation
This page documents the public discovery surface and the most commonly integrated authenticated endpoints for NoCapMocap, including Text-to-Motion and Video-to-Motion workflows.
API catalog
https://www.nocapmocap.com/.well-known/api-catalog
OpenAPI description
https://www.nocapmocap.com/openapi.json
Health endpoint
https://www.nocapmocap.com/api/health
Agent skills index
https://www.nocapmocap.com/.well-known/agent-skills/index.json
MCP server card
https://www.nocapmocap.com/.well-known/mcp/server-card.json
Authentication
Authenticated endpoints expect a bearer access token issued by the site auth server. Public API documentation describes product capabilities and request shapes without exposing private provider or infrastructure details.
Curated endpoints
Public
GET /api/explore
Lists community motions with filters, sorting, and cursor pagination.
- Supports category, characterType, search, sortBy, limit, offset, and cursor query parameters.
- Results are signed for public media access where required.
POST /api/generate
Starts a text-to-motion generation job for the signed-in user.
- Validated request fields include prompt, duration, cfgScale, optional characterType, optional lockRoot, and optional loop.
- The server creates the durable motion row and returns it with the generation identifiers.
- Credit reservation and eligibility checks stay enforced server-side.
GET /api/generate/{id}
Polls a generation by prediction identifier and returns generation assets when complete.
- Only the owner of the prediction can poll it.
- Responses include status and completed asset URLs when available.
POST /api/video-to-motion/uploads
Creates a signed direct-upload reservation for a Video-to-Motion source clip.
- Validated request fields include filename, contentType, and sizeBytes.
- The response returns a short-lived direct-upload URL, upload headers, uploadId, source key, and expiry timestamps.
- The route enforces authentication, credit access, allowed video MIME types, upload size limits, and active upload limits.
POST /api/video-to-motion/generations
Starts a Video-to-Motion generation from a previously uploaded source clip.
- Validated request fields include the server-issued source key and optional settings such as selected clip range.
- The server verifies upload ownership, reserves credits, and queues Video-to-Motion processing server-side.
- Video-to-Motion runs at reduced beta pricing while the beta multiplier is active.
GET /api/video-to-motion/generations
Returns the signed-in user's active or requested Video-to-Motion generation state.
- Supports active=all for active generations and ids for bounded reconciliation by generation id.
- The route verifies ownership before returning generation state.
GET /api/video-to-motion/generations/{id}
Polls a Video-to-Motion generation by id and returns completed assets when ready.
- Only the owner of the generation can poll it.
- Responses may include status, generated motion asset keys or URLs, preview media, metadata, and failure details controlled by the server implementation.
GET /api/profile
Returns the current authenticated profile snapshot.
- This is the simplest authenticated route to verify bearer token wiring.
PATCH /api/profile
Updates the signed-in user profile name or email with server-side validation.
- OAuth-linked users cannot change their email through this route.
GET /api/library
Lists a user library with filtering, pagination, and optional pack metadata.
- Supports category, characterType, tag, search, source_type, includePackInfo, includeTotal, limit, offset, and cursor.
POST /api/polar/checkout-url
Creates a checkout session URL for plans or credit packs.
- Request bodies differentiate between recurring plans and one-time credit packs.