API QUICKSTART / HUMAN + AGENT READY

Build the integration before you create the key.

Use this quickstart to prepare code, validate payloads, and understand the billing model. Live calls require a provider API key created by the human user.

Create API key Using an agent? OpenAPI schema

STATUSVERIFY BEFORE LIVE CALLS

Expected Provider-mediated access

Seedance 2.5 API availability should be verified with the provider before production use. Build behind a configurable model parameter.

CODECURL + NODE

GENERATE.SH

curl https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-reference-to-video",
    "prompt": "A clean product shot, slow dolly in, soft daylight",
    "duration": 5,
    "quality": "720p",
    "generate_audio": true
  }'

GENERATE.MJS

const resp = await fetch("https://api.evolink.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EVOLINK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: process.env.SEEDANCE_MODEL || "seedance-2.5-reference-to-video",
    prompt,
    duration: 5,
    quality: "720p",
    generate_audio: true,
  }),
});

// Returns a job id; poll GET /v1/task-detail?id=<id> until status is completed.
const job = await resp.json();

PARAMETERSREQUEST BODY

Field	Type	Required	Notes
model	string	REQUIRED	Seedance 2.5 model ID (pre-release). Keep configurable.
prompt	string	REQUIRED	Shot description with subject, motion, style, and constraints.
duration	integer	optional	4–30s, default 5. Use short tests first.
quality	string	optional	480p or 720p (default 720p). Treat 1080p/4K as pending.
generate_audio	boolean	optional	Default true. Native audio, included at no extra charge.
content_filter	boolean	optional	Default true (free); false applies a 1.1x cost multiplier.
image_urls / video_urls / audio_urls	array	optional	References: up to 30 / 10 / 10 URLs. Optional.
callback_url	url	optional	HTTPS webhook for async completion. Polling is also acceptable.

Machine-readable schema: /openapi.json / Agent guide: /agent.md

HANDOFFFINAL STEP

Code can be prepared without a key. Live calls cannot.

Create a provider key, add it as EVOLINK_API_KEY, then run a short low-cost test before production traffic.

Create API key