# 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 (480p, 720p, 1080p and native 4K, plus Fast and Mini), Seedance 1.5 Pro and HappyHorse video models, gpt-image-2 image generation and Seedance super-resolution, through one OpenAI-compatible endpoint. There is no queue and no BytePlus account or KYC required, face and portrait generation is supported, and some special SKUs are available that are not on the official platform.

## 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 with `gpt-image-2` (OpenAI-compatible); image output is free, you pay only for input.
- `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: Pay-as-you-go per generated video, no queue and no KYC, failed requests never billed. 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`

## 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

## Key pages
- [Models and live pricing](https://relaydance.com/models)
- [API documentation](https://relaydance.com/docs)
- [Guides index](https://relaydance.com/guides/)

## Guides
- [Client timeout while waiting for video generation setting sensib](https://relaydance.com/guides/client-timeout-while-waiting-for-video-generation-setting-sensib.html)
- [Getting 429 too many requests from the seedance api rate limit c](https://relaydance.com/guides/getting-429-too-many-requests-from-the-seedance-api-rate-limit-c.html)
- [Getting 429 too many requests from the seedance api rate limit c.zh](https://relaydance.com/guides/getting-429-too-many-requests-from-the-seedance-api-rate-limit-c.zh.html)
- [How much does the seedance api cost and how is it billed](https://relaydance.com/guides/how-much-does-the-seedance-api-cost-and-how-is-it-billed.html)
- [How much does the seedance api cost and how is it billed.zh](https://relaydance.com/guides/how-much-does-the-seedance-api-cost-and-how-is-it-billed.zh.html)
- [How to call the seedance 2 0 video generation api](https://relaydance.com/guides/how-to-call-the-seedance-2-0-video-generation-api.html)
- [How to call the seedance 2 0 video generation api.zh](https://relaydance.com/guides/how-to-call-the-seedance-2-0-video-generation-api.zh.html)
- [How to generate 4k video through an api](https://relaydance.com/guides/how-to-generate-4k-video-through-an-api.html)
- [How to generate 4k video through an api.zh](https://relaydance.com/guides/how-to-generate-4k-video-through-an-api.zh.html)
- [How to generate video with audio through an api](https://relaydance.com/guides/how-to-generate-video-with-audio-through-an-api.html)
- [How to generate video with audio through an api.zh](https://relaydance.com/guides/how-to-generate-video-with-audio-through-an-api.zh.html)
- [Image to video api how to animate an image with relaydance](https://relaydance.com/guides/image-to-video-api-how-to-animate-an-image-with-relaydance.html)
- [Image to video api how to animate an image with relaydance.zh](https://relaydance.com/guides/image-to-video-api-how-to-animate-an-image-with-relaydance.zh.html)
- [Image to video request rejected fixing invalid image url size an](https://relaydance.com/guides/image-to-video-request-rejected-fixing-invalid-image-url-size-an.html)
- [Image to video request rejected fixing invalid image url size an.zh](https://relaydance.com/guides/image-to-video-request-rejected-fixing-invalid-image-url-size-an.zh.html)
- [Insufficient quota error on relaydance how to check your balance](https://relaydance.com/guides/insufficient-quota-error-on-relaydance-how-to-check-your-balance.html)
- [Insufficient quota error on relaydance how to check your balance.zh](https://relaydance.com/guides/insufficient-quota-error-on-relaydance-how-to-check-your-balance.zh.html)
- [Multi reference image fusion for video generation](https://relaydance.com/guides/multi-reference-image-fusion-for-video-generation.html)
- [Multi reference image fusion for video generation.zh](https://relaydance.com/guides/multi-reference-image-fusion-for-video-generation.zh.html)
- [Polling a video task returns 404 not found task id errors explai](https://relaydance.com/guides/polling-a-video-task-returns-404-not-found-task-id-errors-explai.html)
- [Polling a video task returns 404 not found task id errors explai.zh](https://relaydance.com/guides/polling-a-video-task-returns-404-not-found-task-id-errors-explai.zh.html)
- [Relaydance api authentication keys and payment](https://relaydance.com/guides/relaydance-api-authentication-keys-and-payment.html)
- [Relaydance api authentication keys and payment.zh](https://relaydance.com/guides/relaydance-api-authentication-keys-and-payment.zh.html)
- [Seedance api relaydance vs byteplus ark direct](https://relaydance.com/guides/seedance-api-relaydance-vs-byteplus-ark-direct.html)
- [Seedance api relaydance vs byteplus ark direct.zh](https://relaydance.com/guides/seedance-api-relaydance-vs-byteplus-ark-direct.zh.html)
- [Seedance api returns 401 unauthorized how to fix invalid api key](https://relaydance.com/guides/seedance-api-returns-401-unauthorized-how-to-fix-invalid-api-key.html)
- [Seedance api returns 401 unauthorized how to fix invalid api key.zh](https://relaydance.com/guides/seedance-api-returns-401-unauthorized-how-to-fix-invalid-api-key.zh.html)
- [Seedance output looks blurry or soft resolution settings and ups](https://relaydance.com/guides/seedance-output-looks-blurry-or-soft-resolution-settings-and-ups.html)
- [Seedance output looks blurry or soft resolution settings and ups.zh](https://relaydance.com/guides/seedance-output-looks-blurry-or-soft-resolution-settings-and-ups.zh.html)
- [Seedance task failed with a content moderation error what gets r](https://relaydance.com/guides/seedance-task-failed-with-a-content-moderation-error-what-gets-r.html)
- [Seedance task failed with a content moderation error what gets r.zh](https://relaydance.com/guides/seedance-task-failed-with-a-content-moderation-error-what-gets-r.zh.html)
- [Text to video api quickstart with an openai compatible endpoint](https://relaydance.com/guides/text-to-video-api-quickstart-with-an-openai-compatible-endpoint.html)
- [Text to video api quickstart with an openai compatible endpoint.zh](https://relaydance.com/guides/text-to-video-api-quickstart-with-an-openai-compatible-endpoint.zh.html)
- [Video generation task stuck in queued how long seedance tasks no](https://relaydance.com/guides/video-generation-task-stuck-in-queued-how-long-seedance-tasks-no.html)
- [Video generation task stuck in queued how long seedance tasks no.zh](https://relaydance.com/guides/video-generation-task-stuck-in-queued-how-long-seedance-tasks-no.zh.html)
- [Webhook callbacks vs polling for long running video tasks](https://relaydance.com/guides/webhook-callbacks-vs-polling-for-long-running-video-tasks.html)
- [Webhook callbacks vs polling for long running video tasks.zh](https://relaydance.com/guides/webhook-callbacks-vs-polling-for-long-running-video-tasks.zh.html)
- [Which video model to use seedance 2 0 vs 1 5 pro vs happyhorse v](https://relaydance.com/guides/which-video-model-to-use-seedance-2-0-vs-1-5-pro-vs-happyhorse-v.html)
- [Which video model to use seedance 2 0 vs 1 5 pro vs happyhorse v.zh](https://relaydance.com/guides/which-video-model-to-use-seedance-2-0-vs-1-5-pro-vs-happyhorse-v.zh.html)