Seedance 2.0

LEAPERone Seedance 2.0 视频生成参考，涵盖任务提交、多媒体引用、状态轮询、固定任务定价和文件下载。

通过国际即梦渠道异步生成 Seedance 2.0 视频。先提交任务，轮询状态，再从 LEAPERone 下载完成的 MP4 文件。

通过 CLI 查阅

CLI 和网站展示同一份文档。文档可以公开阅读；endpoints 命令需要先执行 auth login 或设置 LEAPERONE_API_KEY。

npx @leaperone/cli@latest endpoints
npx @leaperone/cli@latest docs read api-reference/video-generation

创建任务

curl -X POST https://api.leaper.one/v1/videos \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic 9:16 video of a cat running through warm sunlight.",
    "seconds": 15,
    "aspect_ratio": "9:16"
  }'

{
  "id": "video_01234567-89ab-cdef-0123-456789abcdef",
  "object": "video",
  "model": "seedance-2.0",
  "status": "queued",
  "progress": 0
}

参数

参数	类型	必填	说明
`model`	string	是	当前固定为 `seedance-2.0`
`prompt`	string	是	描述主体、动作、镜头、风格和输出限制
`seconds`	integer 或 string	否	`5`、`10` 或 `15`；默认 `15`
`aspect_ratio`	string	否	`16:9`、`9:16` 或 `1:1`；默认 `9:16`
`images`	string[]	否	最多 4 个公开图片 URL 或 base64 data 图片
`videos`	string[]	否	最多 3 个公开视频 URL
`audios`	string[]	否	最多 1 个公开音频 URL

JSON 中不能使用本地文件路径。请先把参考文件上传到公开 URL；支持的图片也可以使用 base64 data URL。

使用 LEAPERone 生成参考图片

如果还没有公开图片 URL，可以先调用图片生成 API。任务完成后会返回签名 URL，Seedance 可以在 1 小时内下载该图片。

export LEAPERONE_API_KEY="sk-your-api-key"

IMAGE_CREATE=$(curl -sS --fail-with-body https://api.leaper.one/v1/images/generations \
  -H "Authorization: Bearer $LEAPERONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-image",
    "prompt": "A bright red paper airplane on a white windowsill in warm morning sunlight, no text",
    "number": 1,
    "size": "9:16"
  }')

IMAGE_ID=$(printf '%s' "$IMAGE_CREATE" | jq -er '.data.id')

for attempt in $(seq 1 120); do
  IMAGE_STATUS=$(curl -sS --fail-with-body \
    "https://api.leaper.one/v1/images/generations/$IMAGE_ID" \
    -H "Authorization: Bearer $LEAPERONE_API_KEY")
  IMAGE_STATE=$(printf '%s' "$IMAGE_STATUS" | jq -r '.data.status')

  case "$IMAGE_STATE" in
    completed|partial)
      IMAGE_URL=$(printf '%s' "$IMAGE_STATUS" | jq -er '.data.images[0].url')
      break
      ;;
    failed) exit 1 ;;
  esac

  sleep 5
done

[ -n "${IMAGE_URL:-}" ] || exit 1

使用 CDN 图片作为参考

Seedance 会从 images 中的 URL 下载参考图片。提交任务前，请确认 CDN URL：

未认证的 GET 请求会返回 200；
返回 image/png、image/jpeg 或 image/webp 等图片 Content-Type；
不依赖 Cookie、浏览器会话，或 Seedance 无法发送的自定义请求头；
在生成完成前持续有效。签名 URL 的有效期至少应为 30 分钟。

先验证图片：

export IMAGE_URL="https://cdn.example.com/reference.png"
curl -fsSL -o /dev/null -D - "$IMAGE_URL"

然后提交图生视频任务。下面是使用 curl 和 jq 的完整 Shell 示例。

export LEAPERONE_API_KEY="sk-your-api-key"

CREATE_RESPONSE=$(curl -sS --fail-with-body https://api.leaper.one/v1/videos \
  -H "Authorization: Bearer $LEAPERONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg image "$IMAGE_URL" '{
    model: "seedance-2.0",
    prompt: "Add subtle natural motion and a slow cinematic camera push-in. Preserve the original composition.",
    seconds: 5,
    aspect_ratio: "16:9",
    images: [$image]
  }')")

echo "$CREATE_RESPONSE"
VIDEO_ID=$(printf '%s' "$CREATE_RESPONSE" | jq -er '.id')

每 10 秒轮询一次，直到任务进入终态：

for attempt in $(seq 1 180); do
  STATUS_RESPONSE=$(curl -sS --fail-with-body \
    "https://api.leaper.one/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $LEAPERONE_API_KEY")
  echo "$STATUS_RESPONSE"

  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.status')
  case "$STATUS" in
    completed) break ;;
    failed|cancelled) exit 1 ;;
  esac

  sleep 10
done

[ "$STATUS" = "completed" ] || exit 1

下载完成的视频：

curl -fL "https://api.leaper.one/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $LEAPERONE_API_KEY" \
  -o result.mp4

如果任务返回 failed，请更换参考图片或提示词并创建新任务。常见原因包括 CDN URL 已过期、URL 需要认证，或内容审核未通过。失败和取消的任务不会计费。

轮询状态

curl https://api.leaper.one/v1/videos/video_01234567-89ab-cdef-0123-456789abcdef \
  -H "Authorization: Bearer sk-your-api-key"

状态值包括 queued、processing、completed、failed 和 cancelled。

下载视频

curl -L https://api.leaper.one/v1/videos/video_01234567-89ab-cdef-0123-456789abcdef/content \
  -H "Authorization: Bearer sk-your-api-key" \
  -o result.mp4

计费和日志

提交任务时会预留点数。
每个成功的视频任务固定消耗 1 点数（$1.00），请求 5、10 或 15 秒均为相同价格。人民币充值使用平台固定汇率，并可能包含渠道费用。
只有任务进入 completed 后才会结算费用。
失败和取消的任务会释放预留点数。
用量历史会记录请求 ID、API Key、公开模型、时长、渠道和最终费用。
每个响应都包含 X-Request-Id。联系支持时请保留该值。
API 响应和用量日志不会暴露提示词、参考媒体内容、上游任务 ID、上游 URL 或凭据。
任务 ID 只对所属 LEAPERone 账户有效。其他用户查询时会收到 404。

目录