SeedanceLink
充值登录

开发者接入文档

从提示词到视频，直接接入。

示例调用的是 SeedanceLink。请使用自己的 API Key；Google 登录会话用于网页控制台。

本页目录

开始之前

登录、充值足够的余额，并在启用 Seedance 的分组创建 API Key。下方最小示例请求 4 秒、480p 视频。

创建自己的 API Key 模型与价格

身份验证

创建、查询和下载请求均需携带 Authorization: Bearer YOUR_API_KEY。使用创建该任务的同一个 Key，密钥不要放进 URL。

Authorization: Bearer YOUR_API_KEY
API 域名https://seedancelink.io

未填写时，时长默认为 5 秒，分辨率默认为 720p。示例明确选择 4 秒、480p。请发送 application/json，并使用模型页展示的两个模型 ID 之一。

请在同一个 macOS/Linux 终端或 Windows WSL 中运行以下 curl 示例。第一步设置您的密钥和本站 API 地址，请妥善保管密钥。

创建任务

示例生成 4 秒视频，请保存 API 返回的 id。Seedance 2.0 支持 4–15 秒，Seedance 2.5 支持 4–30 秒；均支持 480p、720p 和 1080p。

POST /api/v3/contents/generations/tasks
API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "日出时，一艘小船驶过平静的湖面，电影感光线。"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

响应示例

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

保存响应中的任务 ID，后两步使用这个 ID。

查询状态

将 REPLACE_WITH_RESPONSE_ID 替换为返回的 id。queued 或 running 时每 15 秒查询一次，succeeded 后下载。failed 或 needs_reconcile 时停止轮询；needs_reconcile 请联系支持处理，不要自动重新创建任务。

响应示例

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

约每 15 秒查询一次；状态为 succeeded 后再下载。

下载视频

使用创建任务时的同一把密钥。下载接口需要 Bearer 密钥，直接在浏览器打开链接无法完成认证。curl 仅跟随 HTTPS 下载跳转，不会把密钥传给其他主机。

任务状态与计费

queued
已接受，等待生成。
running
正在生成。
succeeded
已完成，可以通过需要身份验证的内容接口下载。
failed
生成失败，预留金额已退回。
needs_reconcile
提交结果不确定，金额保留，等待核对。

生成前，先确认报价。

请求秒数 × 分辨率单价 × 适用倍率。提交时预留报价金额，生成成功后收取，失败则退回。

用同一个 Key 下载

状态为 succeeded 后，使用 content.video_url 或下方内容接口，并携带 API Key。已付费任务可以在余额为零时继续下载。

提交结果不确定时

202 回执中的 needs_reconcile 仍包含本站任务 ID。保存这个 ID 并查询，不要自动创建另一个任务：原任务的金额仍处于预留状态。