TOKTESK DEVELOPER PLATFORM

一次接入，调用
2.0 与 2.5
视频模型

用统一的 REST API 生成视频、查询进度和获取限时下载地址。平台统一管理生成服务，客户设备只使用各自的独立 Key。

POST /v1/videos

curl https://toktesk.com/v1/videos \
  -H "Authorization: Bearer sk-tt-..." \
  -H "Idempotency-Key: order-20260914-001" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "产品展示短片",
    "model": "seedance2.0fast",
    "duration": 10,
    "ratio": "9:16"
  }'

202 ACCEPTED{ "id": "…", "status": "queued" }

Bearer API Key每条固定 10 积分幂等安全重试限时签名下载

QUICK START

三步完成接入

创建客户 Key

登录工作台进入“API 接入”，按客户设置每日任务额度和并发。完整 Key 只显示一次。

提交生成任务

携带 Bearer Key 与唯一 Idempotency-Key。参考图先上传到文件接口，再将 image_id 放入任务。

轮询并下载

查询任务直到 succeeded，再获取 10 分钟有效的签名地址。视频仍由 TokTesk 服务器统一保存。

MODEL CATALOG

保留原始模型名称

FAST

2.0 Fast

5 / 10 / 15 秒 · 最多 9 张参考图

seedance2.0fast

BALANCED

2.0

5 / 10 / 15 秒 · 最多 9 张参考图

seedance2.0

LIGHT

2.0 Mini

5 / 10 秒 · 最多 9 张参考图

seedance2.0mini

STORY

2.5

30 秒 · 最多 30 张参考图

seedance2.5

REST ENDPOINTS

面向 AI 软件的完整调用流程

GET/v1/catalog模型与能力

GET/v1/pricing统一计费

GET/v1/balance积分与流水

POST/v1/files上传参考图

POST/v1/videos创建视频任务

GET/v1/videos/{id}查询任务状态

GET/v1/videos/{id}/signed_url获取下载地址