RelayDanceDocs / API Reference
API Reference
All RelayDance endpoints share the same base URL and authentication scheme. Click an endpoint for full parameter documentation and examples.
#Base URL
https://relaydance.com/v1
#Authentication
Pass your API key as a bearer token in every request:
| Header | Value |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
#Endpoints
Generate Video
/v1/video/generations
Submit an asynchronous video generation task
Get Video Task
/v1/video/generations/{task_id}
Poll task status and fetch the finished clip
Upload Files
/v1/files
Upload reference media (multipart form)
Chat Completions
/v1/chat/completions
OpenAI-compatible LLM chat
Generate Image
/v1/images/generations
OpenAI-compatible image generation
List Models
/v1/models
Models available to your key
Video generation is asynchronous: submit returns a task_id, then poll the task or set metadata.callback_url to receive a webhook. The Video Generation guide walks through the full flow.
#Error codes
| Status | Meaning |
|---|---|
400 Bad Request | Missing or invalid parameters |
401 Unauthorized | Missing or invalid API key |
403 Forbidden | Quota or permission issue |
404 Not Found | Unknown model ID or task ID |
429 Too Many Requests | Rate limit exceeded |
5xx Server Error | Upstream or gateway error, retry with back-off |
See Error Codes for details and retry recipes.