快速开始
使用灵剧塔模型开放平台调用文本、图像和视频模型。
接入之前
灵剧塔提供统一的模型接入入口。本文帮助你完成密钥准备、模型选择与第一次视频任务调用。
你需要准备
一个平台账号、一枚 API Key，以及可以发起 HTTPS 请求的服务端环境。
第一步：获取 API 密钥
- 打开 API 密钥管理页面。
- 登录账号并创建 API Key。
- 安全保存密钥，在服务端通过环境变量读取。
不要将密钥放入浏览器代码、公开仓库或截图。完整鉴权说明见 身份认证。
第二步：选择模型
| 类型 | 接入方式 | 说明 |
|---|---|---|
| 文本 | OpenAI 兼容格式 | 从模型广场选择可用模型；文本接入说明 |
| 图像 | 以模型协议为准 | 不同模型的输入与产物结构可能不同；图像接入说明 |
| 视频 | Seedance 原生协议 | 支持提交异步任务，再按任务 ID 查询；创建视频任务 |
完整可用模型与权限请以 模型广场 和你的账号配置为准。
第三步：发送请求
下面使用已经核对接口定义的 Seedance 原生协议。将 API_BASE_URL 设置为平台提供的 API 服务根地址，不要包含 /v1 或 /api/v3 后缀。
sh
export API_BASE_URL='https://YOUR_API_HOST'
export LINGJUTA_API_KEY='YOUR_API_KEY'sh
curl --fail-with-body "${API_BASE_URL}/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer ${LINGJUTA_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2.0-mini",
"content": [{ "type": "text", "text": "一只猫在海边奔跑，镜头缓缓跟随" }]
}'成功提交后返回任务 ID：
json
{
"id": "00000000-0000-4000-8000-000000000001"
}这表示任务已受理。视频生成需要时间，请继续查询任务状态。
第四步：查询异步任务
sh
curl --fail-with-body \
"${API_BASE_URL}/api/v3/contents/generations/tasks/YOUR_TASK_ID" \
-H "Authorization: Bearer ${LINGJUTA_API_KEY}"queued 和 running 表示任务尚未完成；succeeded 表示成功，可以读取 content.video_url；failed、cancelled、expired 为其他终态。
查询时设置合理间隔、最长等待时间，并在终态停止。参见 查询视频任务。