Clipwave Public API · v1
Generate video & images programmatically
REST endpoints + MCP server for Seedance 2.0 video generation and Nano Banana 2 image generation. Same engine as the web app, billed against the same credit balance.
Get started
Quickstart
3-step quickstart: get a key, submit your first generation, poll the result.
Authentication
Bearer tokens, scopes, rate limits, security best practices.
Endpoints
Full reference for all /api/v1/* routes with request/response schemas.
Examples
Working code in curl, TypeScript, and Python.
Account
API Keys
Create, label, revoke API keys. Each key shown plaintext exactly once at creation.
Usage
Your last 50 API calls: endpoint, status, credits consumed, job ID.
Errors
HTTP status codes, common messages, refund semantics.
Use it from your AI assistant
Hosted MCP server — live for Claude Code, Claude Desktop, Cursor, Windsurf
Nothing to install. Point any MCP client at the hosted endpoint and authenticate with the same cw_live_ key: 17 tools covering the model catalog, image and video generation, and the full Media Studio editor (create → instruct → export).
claude mcp add clipwave \ --transport http https://clipwave.io/api/mcp \ --header "Authorization: Bearer cw_live_…"
Cursor, Windsurf and generic clients: full setup, tool catalog and an example agent run on clipwave.io/mcp. The endpoint self-briefs on connect via initialize.instructions, so agents learn the tools automatically.
Models in Phase 1
| Model | Type | Endpoint | Cost |
|---|---|---|---|
| Seedance 2.0 | video | POST /api/v1/video/seedance-2/generate | 227cr/s @720p · 101cr/s @480p (audio incl.) |
| Seedance 2.0 Fast | video (t2v) | ↑ same, with fast: true | 181cr/s (audio incl.) |
| Nano Banana 2 | image | POST /api/v1/image/nano-banana/generate | 50cr/image |
Need more models? The hosted MCP already exposes the full Media Forge catalog via list_models + media_forge_generate. Dedicated REST endpoints for more models are next. No markup vs. UI usage.