How to generate 4K video through an API

To generate 4K video through an API, send a POST request to /v1/video/generations on RelayDance with a model, prompt, and seconds value, then poll GET /v1/video/generations/{task_id} until the status is succeeded. RelayDance is OpenAI compatible, so you set base_url to https://relaydance.com/v1 and keep the OpenAI SDK. Seedance native 4K is priced at about $4.90 per 5 second clip (see relaydance.com/models).

What endpoint and protocol does RelayDance use?

RelayDance uses an OpenAI-compatible HTTP protocol, so you can call it with the OpenAI SDK after one change. According to the documentation, "set base_url to https://relaydance.com/v1 and keep your OpenAI SDK"According to the official relaydance.com/docs. To start a video task, send POST /v1/video/generations with model, prompt, and seconds, plus optional metadata (ratio, resolution, generate_audio, callback_url). Authenticate with the header Authorization: Bearer YOUR_API_KEY, where keys are created in the console. For images, use POST /v1/images/generations. Full reference details are in the documentation.

How do you generate 4K video step by step?

You generate 4K video by submitting a task, polling for completion, and reading the result URL. Follow these steps:

1. Set base_url to https://relaydance.com/v1 and add the header Authorization: Bearer YOUR_API_KEY.
2. Send POST /v1/video/generations with model, prompt, seconds, and metadata.resolution set for 4K output.
3. Poll GET /v1/video/generations/{task_id} until status is succeeded or failed, or set metadata.callback_url for webhook delivery.
4. Read the video URL from the result.

You may attach reference media in metadata.content[] and cite them in the prompt as @image1 to @imageN, up to 9 reference images, 3 reference videos, and 3 audio tracks per request, with clips up to 15 seconds.

How much does video and image generation cost?

Pricing is pay-as-you-go per generated output, with rates listed per model. The table below shows current Seedance rates from relaydance.com/models:

For gpt-image-2, image output is free and billing applies to input only; image-to-image starts at about ¥0.035, and 4K output is priced the same as 1K output.

What happens when a request fails?

When a request fails, RelayDance does not charge for it. According to the documentation, "failed or errored requests are never billed"According to the official relaydance.com docs, which means failed or errored requests are never billed. This applies to pay-as-you-go usage across video and image endpoints. Payments are accepted via USDT and Stripe card, and you create API keys in the console. Access to Seedance is direct and OpenAI compatible, with no BytePlus enterprise account or KYC required. For live per-model rates, including the $4.90 per 5 second 4K clip, check relaydance.com/models.

FAQ

Do I need a special SDK to call RelayDance?
No. The API is OpenAI compatible: set base_url to https://relaydance.com/v1 and keep the OpenAI SDK.

How many reference files can I include in one request?
Up to 9 reference images, 3 reference videos, and 3 audio tracks, placed in metadata.content[] and cited as @image1 to @imageN.

Am I charged if a generation fails?
No. Failed or errored requests are never billed.