Seedance 2.5

Seedance 2.5 reference to video uses the model id bytedance/seedance-2.5/reference-to-video. Sharpest realism, native audio, up to 30 references — also edits clips

1. Calling the API

Endpoint

Send a POST to https://api.elyum.ai/v1/generations with a JSON body matching the parameters below. Every model uses the same endpoint; the model field picks this one.

const res = await fetch("https://api.elyum.ai/v1/generations", {  method: "POST",  headers: {    Authorization: `Bearer ${process.env.ELYUM_API_KEY}`,    "Content-Type": "application/json",    Prefer: "wait=55",  },  body: JSON.stringify({    "model": "bytedance/seedance-2.5/reference-to-video",    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",    "inputs": [      {        "role": "reference",        "url": "https://example.com/reference.jpg"      }    ]  }),});const generation = await res.json();console.log(generation.status, generation.outputs);

Request parameters

A value outside these lists is refused with a 400 naming the field, before anything is charged. Nothing is quietly rounded or dropped.

Inputs

A reference image wider or taller than 0.4 to 2.5 (width ÷ height) is padded to fit, never cropped. An image under 300 or over 6,000 px a side is scaled to fit. A clip outside 300 to 6,000 px a side, or 409,600 to 8,295,044 pixels, is rescaled; its length and sound are kept.

Cite an input in the prompt by type and order (@image1, @video1, @audio1), or give it a name and cite @name. An input outside these limits is refused with a 400 naming it, before anything is charged.

2. Authentication

API key

Create a key on Keys with the generate and spend scopes and send it as a bearer token. Keep it on your server; never send it to a browser.

Authorization: Bearer $ELYUM_API_KEY

3. Queue

Submit and wait

With Prefer: wait=55 the request holds until the render ends or 55 seconds pass. A finished render answers 200 with its outputs; one still running answers 202 with its id. This task usually takes about 30 min.

Poll and cancel

const headers = { Authorization: `Bearer ${process.env.ELYUM_API_KEY}` }; // Poll until the render ends: succeeded, failed or canceledlet generation = await (await fetch(`https://api.elyum.ai/v1/generations/${id}`, { headers })).json();while (generation.status === "queued" || generation.status === "running") {  await new Promise((r) => setTimeout(r, 5000));  generation = await (await fetch(`https://api.elyum.ai/v1/generations/${id}`, { headers })).json();} // Or stop it (a hold is refunded)await fetch(`https://api.elyum.ai/v1/generations/${id}/cancel`, { method: "POST", headers });

Output links are signed and last 24 hours: download them to your own storage, or fetch the generation again for fresh ones.

4. Pricing

A struck price is the list price before today's. A reference clip's seconds are charged too, an edit's source clip included: every second of the clip and the output together at the rate in that column. Seedance 2.5 counts it in tokens (width × height × frames of output and clip). Send ?dry_run=true for the exact price of a request with nothing held. The API spends your API balance; a render that fails or is canceled costs nothing.