> ## Documentation Index > Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt > Use this file to discover all available pages before exploring further. # List 3D model moves > The moves a rigged Meshy 7.1 character can perform, by category (dancing, everyday, walking and running, moves and stunts, fighting). Send a move's `id` as `animation_move` on [`POST /v1/3d/meshy-7.1`](/api-reference/3d-models/generate-a-3d-model-with-meshy-71) together with `rigging: true` and `animation: true`. Free. Without `animation_move`, the animated model performs move 92, Double Combo Attack. ## OpenAPI ````yaml /openapi.yaml get /3d/moves openapi: 3.1.0 info: contact: email: support@budgetpixel.com name: BudgetPixel Support description: > The BudgetPixel developer API for programmatic image, video, music and sound-effect generation. Generation is **asynchronous**: you create a job, then poll its status until it reaches a terminal state (`succeeded` / `failed`). You are charged in credits only on success — never for failures, timeouts, or content blocked before generation. **Authentication.** All requests require an API key sent as a bearer token: Authorization: Bearer bpx_live_xxx Create and manage keys from your BudgetPixel account dashboard. The developer API is available on **every paid plan**. On the **Free** plan, API keys can call the free library searches only: `GET /v1/stock/images`, `GET /v1/stock/sound-effects` and `GET /v1/stock/music`. **Pricing.** API usage is metered in credits at each model's published price (see `GET /v1/models`), and your plan's model discounts and active promotions apply to API charges exactly as they do on the web — `POST /v1/cost` quotes your discounted price. Pro and Ultra plans include a daily free-models allowance (a shared pool of free generations per day across qualified image models such as FLUX 2 Klein and Qwen-Image) that covers API requests too — the standard price applies once the day's pool is used. Other promotional free daily generations remain web/app-only. Failed generations are never charged. **Rate limits.** Requests are limited per minute: **600 requests/min per API key** and **1200 requests/min per source IP** (defaults; subject to tuning). Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (seconds until the window resets). Exceeding a limit returns HTTP `429` with a `Retry-After` header — wait that long before retrying. Rejected requests still count against the window, so a tight retry loop keeps you limited; back off instead. Generation jobs additionally have a per-plan concurrency cap (the same one as the web workshop), independent of these request limits. `POST /v1/uploads` also has a dedicated **60 uploads/min per account** cap (it's free/unmetered) on top of these limits. Every `429` this API returns carries `Retry-After`, including a full concurrency queue (a suggested wait) and the monthly spend limit (seconds until the month resets). **Characters.** Write `@handle` in the prompt of an image or video generation to cast a character: one of the free BudgetPixel AI influencers (`@barry`, `@rosa`, ...) or a character of your own. Its picture and look go with the mention, so the same face appears in every post. `GET /v1/characters` lists the ones you can cast, `GET /v1/characters/{handle}` gives one in full with every picture, and `POST /v1/characters/recommend` picks influencers for a brief. **Output retention.** Generated files are kept for 24 hours after the job is created. Job status responses give the exact time as `expires_at`; after it, `expired` is `true` and no download URLs are returned. title: BudgetPixel API version: '2026-06-20' servers: - description: Production url: https://api.budgetpixel.com/v1 security: - ApiKeyAuth: [] tags: - description: Account and credit balance name: Account - description: Discover available models and pricing name: Models - description: Upload input media for image/video generation name: Uploads - description: Image job status name: Images - description: FLUX image models name: Black Forest Labs - description: SeeDream image models name: Bytedance - description: Video job status name: Videos - description: Kuaishou Kling video models name: Kling - description: SeeDance video models name: ByteDance (SeeDance) - description: Music and sound-effect job status name: Audios - description: Music generation models name: Music - description: Text-to-sound-effect models (priced per second) name: Sound Effects - description: >- Image-to-3D models — a picture in, a textured 3D model (GLB, plus FBX/USDZ/STL on Meshy) out name: 3D Models - description: Format conversion for images, video, and audio name: Conversions - description: Publish posts to your BudgetPixel feed and enter clan themes name: Social - description: Cast BudgetPixel AI influencers and your own characters with @mentions name: Characters - description: Content moderation — NSFW rating and CSAM detection name: Moderation - description: Content classification — music genre detection name: Classification - description: >- Search the free stock image library — available on every plan, including Free name: Stock Images - description: >- Search the free sound effect library — available on every plan, including Free name: Stock Sound Effects - description: >- Search the free background music library — available on every plan, including Free name: Stock Music - description: >- Turn a video into a depth map video to guide other video models with its structure and motion name: Depth Maps paths: /3d/moves: get: tags: - 3D Models summary: List 3D model moves description: > The moves a rigged Meshy 7.1 character can perform, by category (dancing, everyday, walking and running, moves and stunts, fighting). Send a move's `id` as `animation_move` on [`POST /v1/3d/meshy-7.1`](/api-reference/3d-models/generate-a-3d-model-with-meshy-71) together with `rigging: true` and `animation: true`. Free. Without `animation_move`, the animated model performs move 92, Double Combo Attack. operationId: list3DMoves responses: '200': content: application/json: schema: $ref: '#/components/schemas/Model3DMoves' description: The moves, by category. '401': $ref: '#/components/responses/Unauthorized' components: schemas: Model3DMoves: properties: api_default_move: description: >- The move an animated model performs when no `animation_move` is sent (92). type: integer categories: description: Move groups in display order. items: properties: key: description: dancing, daily, walk_run, body or fighting. type: string label: type: string moves: items: properties: id: description: The value to send as `animation_move`. type: integer name: type: string subcategory: type: string type: object type: array type: object type: array default_move: description: The move the BudgetPixel 3D tool starts with (a dance). type: integer note: type: string total: description: Number of moves listed. type: integer type: object Error: properties: error: properties: code: description: Stable machine-readable code. example: model_not_available type: string message: type: string type: description: Error category. example: invalid_request_error type: string required: - type - code - message type: object required: - error type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. securitySchemes: ApiKeyAuth: bearerFormat: bpx_live_* description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx' scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.