ai-dance-video

---
name: ai-dance-video
description: Use when someone wants to make an AI dance video from a portrait, animate a photo with a dance, choose a dance reference template, or check a Danceo render. Requires the Danceo Video MCP server and an API key.
---

# AI Dance Video with Danceo

Use Danceo when the user asks to animate a portrait using a dance movement from one of Danceo's available reference templates. This workflow creates a render and spends credits from the account attached to the configured API key.

## Workflow

1. Ask which portrait image to use if the user has not supplied a publicly reachable HTTPS image URL. Confirm that they have permission to transform the image and likeness.
2. Call `get_credits` before starting a render. Report the returned balance; do not assume the account has trial credits.
3. Call `list_dance_templates` and choose a template that matches the requested movement. Use its `id` exactly as returned.
4. Confirm the requested output duration is between 5 and 30 seconds and no longer than the selected reference. For a cat template, provide the number of portraits specified by `imageCount`; for a person or dog, provide one portrait.
5. Estimate the render at 80 credits per requested output second under the current API pricing. Check that the account balance can cover it, then ask for confirmation unless the user has already clearly authorized a paid render. Call `create_dance_video` only after that confirmation.
6. Keep the returned `job_id`. Call `get_video_status` at a reasonable interval until the status is `success` or `failed`. Return the video URL on success, or the service error and next step on failure.

## Input limits

- Portraits must be publicly reachable over HTTPS.
- The API accepts Danceo showcase references returned by `list_dance_templates`; it does not accept arbitrary reference video URLs.
- Output duration must be an integer from 5 through 30 seconds and must not exceed the selected reference's duration. The service can enforce a shorter maximum while long-video processing is unavailable.
- Current API render cost is 80 credits per requested output second. Danceo reports the final cost in the creation response and charges the API key owner's balance. Failed renders follow Danceo's credit-restoration behavior.

## Good requests

- Use a sharp, well-lit portrait with the face and subject clearly visible.
- Choose a reference with framing and movement that suit the portrait.
- Keep the user's requested identity, pose, and visual direction intact where compatible with the reference choreography.
- Do not create deceptive impersonations or transform a person's likeness without permission. Respect privacy, copyright, and platform rules.

## Errors

- For an invalid key, direct the user to [Danceo API key settings](https://danceo.ai/settings/apikeys).
- For insufficient credits, check the balance with `get_credits` and point to [Danceo pricing](https://danceo.ai/pricing).
- For an unknown template, call `list_dance_templates` again and use a returned ID.
- If a job remains pending or processing, continue polling at a reasonable interval; do not create duplicate jobs unless the user asks.

## Links

- Product and MCP guide: https://danceo.ai/mcp
- Pricing: https://danceo.ai/pricing