# RelayDance

> Seedance video generation API: OpenAI-compatible, asynchronous, webhook callbacks, multi-reference fusion. Base URL `https://relaydance.com/v1`.

RelayDance (relaydance.com) is a video-first AI generation API. It serves ByteDance Seedance 2.0 and Seedance 1.5 Pro video models, HappyHorse video models and xAI Grok Imagine video and image models, plus Grok text models, through one OpenAI-compatible endpoint.

## API quick reference

Base URL: `https://relaydance.com/v1`

- `POST /v1/video/generations` submits a video task. Body: `model`, `prompt`, `seconds`, and `metadata` for vendor parameters (`ratio`, `resolution`, `generate_audio`, `callback_url`, `content[]` reference media).
- `GET /v1/video/generations/{task_id}` polls the task until `status` is `succeeded` or `failed`; the result includes the video `url`.
- Webhook mode: set `metadata.callback_url` at submit time and the final task state is POSTed to your server, with retries. No polling needed.
- Reference media go in `metadata.content[]` as `{ "type": "image_url", "image_url": { "url": "..." }, "role": "reference_image" }` entries and are cited in the prompt as `@image1` to `@imageN`. Up to 9 reference images, 3 reference videos and 3 audio tracks per request.
- `POST /v1/images/generations` generates images (OpenAI-compatible).
- `POST /v1/chat/completions` serves the Grok text models (OpenAI-compatible).
- `POST /v1/files` uploads media files.
- `GET /v1/models` lists models for your key.

Authentication: `Authorization: Bearer YOUR_API_KEY` (create keys in the console: https://relaydance.com/console)
Payments: USDT and Stripe (credit / debit card)
Pricing: Mainstream model groups are priced 30% or more below official list prices. Live per-model rates: https://relaydance.com/models
Failed or errored requests are never billed.

## Video models

- `doubao-seedance-2-0-1080p`
- `doubao-seedance-2-0-720p`
- `doubao-seedance-2-0-fast-260128`
- `happyhorse-1.0-i2v`
- `happyhorse-1.0-r2v`
- `happyhorse-1.0-t2v`
- `happyhorse-1.0-video-edit`
- `grok-imagine-video`
- `grok-imagine-video-1.5-preview`

## Image models

- `grok-imagine-image`
- `grok-imagine-image-quality`

## Text models

- `grok-4.20-0309-non-reasoning`
- `grok-4.20-0309-reasoning`
- `grok-4.20-multi-agent-0309`
- `grok-4.3`
- `grok-build-0.1`

## Links

- Console and API keys: https://relaydance.com/console
- Live model list and pricing: https://relaydance.com/models
- Docs: https://relaydance.com/docs
- Video API reference: https://relaydance.com/docs/video