RelayDanceDocs / Model APIs / Overview
Model APIs: Overview
All RelayDance requests share one base URL, https://relaydance.com/v1, and one API key. The model field in the request body selects which model handles it.
#Endpoints
| Modality | Endpoint |
|---|---|
Video (submit) | POST /v1/video/generations |
Video (poll) | GET /v1/video/generations/{task_id} |
Image | POST /v1/images/generations |
File upload | POST /v1/files |
Model list | GET /v1/models |
#Listing available models
The authoritative model list is per key: call GET /v1/models with your key and you get exactly the IDs you can use. The public Models page shows the same catalog with pricing.
curl https://relaydance.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"#Providers
Video and image models from leading AI labs:
| Provider |
|---|
ByteDance (Seedance) |
HappyHorse |
OpenAI (gpt-image-2) |
#Video models
| Model ID | Family | Notes |
|---|---|---|
| doubao-seedance-2-0-1080p | Seedance 2.0 | Flagship quality, 1080p output |
| doubao-seedance-2-0-720p | Seedance 2.0 | 720p output |
| doubao-seedance-2-0-480p | Seedance 2.0 | 480p output |
| doubao-seedance-2-0-4k | Seedance 2.0 | Native 4K output |
| doubao-seedance-2-0-fast-260128 | Seedance 2.0 | Fast tier, faster generation |
| doubao-seedance-2-0-mini-260615 | Seedance 2.0 | Mini tier, lightweight |
| seedance-1-5-pro-with-audio | Seedance 1.5 | Generated audio included |
| seedance-1-5-pro-no-audio | Seedance 1.5 | Silent output |
| happyhorse-1.0-t2v | HappyHorse | Text-to-video |
| happyhorse-1.0-i2v | HappyHorse | Image-to-video |
| happyhorse-1.0-r2v | HappyHorse | Reference-to-video |
| happyhorse-1.0-video-edit | HappyHorse | Video editing |
All video models use the asynchronous task API. See Video Generation.
#Super-resolution
Upscale a finished clip with the super-resolution models. seedance-upscale-720p (480p to 720p) is live now. seedance-upscale-1080p, seedance-upscale-2k and seedance-upscale-4k are in the catalog and coming soon.
#Image models
| Model ID | Family | Notes |
|---|---|---|
| gpt-image-2 | Image | Text-to-image; image output is free, you pay only for input |
#Authentication
Every endpoint uses the same bearer token scheme:
| Header | Value |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
#Synchronous vs asynchronous
Image requests return their result in the response. Video generation is asynchronous: submitting returns a task_id, and you poll GET /v1/video/generations/{task_id} or receive a webhook via metadata.callback_url.