For Agents & MCP

You are helping me use SeedanceAPI to generate AI video and images.

Base URL: https://api.seedanceapi.us
API key: use the user's SeedanceAPI key from their dashboard (format ak_...)
Auth header: Authorization: Bearer <api_key>

Capabilities:
- Video: SeedDance 2.5 / 2.0 (billed per second)
- Image: Seedream 5.0 / 4.x (billed per generation)

Workflow:
1. GET /v1/credits — check balance (returns balance_usd)
2. Optional: POST /v1/media/upload (multipart file) → { url } for image_url / video_url inputs
3. POST /v1/videos with JSON { model, prompt, duration?, aspect_ratio?, image_url? } → { id }
4. Poll GET /v1/generations/{id} until status is completed or failed
5. Use output_url when completed
6. For images: POST /v1/images returns output_urls immediately

Example models:
- seedance-2.5/text-to-video
- seedance-2.0-fast/text-to-video
- seedream-5.0/text-to-image

On 402, tell me to add balance at https://seedanceapi.us/pricing.

Start by listing models, then help me generate what I ask for.

{
  "mcpServers": {
    "seedance": {
      "url": "https://api.seedanceapi.us/mcp",
      "headers": {
        "Authorization": "Bearer ak_YOUR_API_KEY"
      }
    }
  }
}

Starter files

Drop these into your agent project, or copy the contents.