VIDEO API

即梦通道 API 中文文档

统一通过 New API 鉴权，调用多个已接入的视频生成渠道。

Base URL：https://api.sd99.vipBearer Token异步任务

快速开始

1. 获取 Key

由管理员在 New API 后台为每位客户创建独立 API Key。

2. 配置地址

https://api.sd99.vip

3. 创建并查询

创建任务后保存 task_id，持续查询直到 completed 或 failed。

获取模型列表

curl https://api.sd99.vip/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

身份验证

Authorization: Bearer YOUR_API_KEY

不要公开：管理员账号、上游 API Key、服务器 SSH 信息、内网地址和 8080–8083 端口。

当前公开模型

实际可用模型以 GET /v1/models 返回结果为准。

渠道	公开模型名	说明
火山年框	`video-sd-720p-proⅠ` `video-sd-720p-VIPⅠ`	分别映射到 77_16 与 doubao-seedance-2.0
newtoken	`video-sd-720p-pro` `video-sd-480p-pro` `video-sd-480p-pro-i` `video-sd-480p-pro-I`	部分模型由适配器映射至上游视频模型
灵动	`video-cvk-2`、`video-cvk-4k`、`video-cvk-1080`、`video-cvk-5`、`video-cvk`、`video-cvk-2-2`、`video-cvk-6`、`cvk-image-2`、`video-cvk-s`	支持灵动系列视频模型
Dimensio	`video-sd-480p-pro`、`video-sd-1080p-pro`、`seedance-2.0`、`seedance-2.0-fast`	由 Dimensio 适配器处理

创建视频

推荐接口：

POST /v1/videos/generations

兼容接口：

POST /v1/videos

文生视频示例

curl https://api.sd99.vip/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-sd-720p-proⅠ",
    "prompt": "一只橘猫在阳光下缓慢走过草地，镜头平稳",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

常用字段

字段	类型	说明
`model`	string	使用 /v1/models 返回的公开模型名
`prompt`	string	提示词，必填
`duration` / `seconds`	integer	视频时长，范围按模型支持
`aspect_ratio` / `ratio`	string	例如 16:9、9:16、1:1
`resolution`	string	例如 720p；仅部分渠道使用
`image_url`	string	首张参考图 URL
`extra_images` / `images`	array	额外参考图
`videos` / `video_urls`	array	参考视频
`audios` / `audio_urls`	array	参考音频
`reference_mode`	string	参考模式，仅部分渠道支持

查询任务

curl https://api.sd99.vip/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

完成后优先读取 video_url，其次读取 result.url。

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://...",
  "result": {
    "url": "https://..."
  }
}

参考素材

curl https://api.sd99.vip/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-sd-720p-pro",
    "prompt": "让参考图中的人物自然转身并看向镜头",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_url": "https://example.com/reference.jpg",
    "extra_images": ["https://example.com/reference-2.jpg"]
  }'

参考 URL 必须能被上游公网访问。K99 画布会按其上传流程处理本地素材。

K99 画布配置

项目	填写内容
画布地址	https://ai.k99.tw/video
调用格式	`OpenAI`
Base URL	`https://api.sd99.vip`
Key	管理员分配的客户 API Key
模型	点击“拉取模型”后选择

错误处理

HTTP	常见原因	处理方式
400	缺少 prompt 或参数格式错误	检查请求体
401	Key 无效、过期或未携带	检查 Bearer Token
403	权限不足或资源访问限制	检查令牌权限与额度
429	额度不足或请求过快	充值、提高额度或稍后重试
502	上游连接失败或上游返回异常	稍后重试并联系管理员

注意：/v1/chat/completions 在部分渠道仅用于渠道连接测试。正式视频生成请使用 /v1/videos/generations。