文本生成视频

POST /videos/generations

输入文字描述，生成视频。适用于电商主图视频、短视频营销、产品展示等场景。

接口信息

项目	说明
接口地址	POST https://api.seeany.com/v1/videos/generations
Content-Type	application/json
认证方式	Bearer Token
超时时间	异步（返回 task_id）

异步接口

视频生成为异步任务，创建后返回 task_id，需通过轮询或 Webhook 获取结果。详见 查询任务状态。

请求参数

必填参数

参数	类型	说明
model	string	生成模型（见模型清单）
prompt	string	视频场景描述

可选参数

参数	类型	默认值	说明
duration	integer	5	时长（秒），取决于模型支持
resolution	string	720p	分辨率：480p / 720p / 1080p
audio	boolean	false	是否生成音频
aspect_ratio	string	16:9	画面比例：16:9 / 9:16 / 1:1
webhook_url	string	-	任务完成回调地址

请求示例

Python

from seeany import SeeAny
import time

client = SeeAny(api_key="sk-xxxxx")

# 提交视频生成任务
task = client.videos.generate(
    model="kling-v3",
    prompt="一双白色运动鞋在旋转展示台上缓慢旋转，极简白色背景，studio灯光，慢动作特写",
    duration=5,
    resolution="720p",
    audio=False,
    webhook_url="https://your-app.com/webhook/video-complete"
)

print(f"任务已提交: {task.id}，预计 {task.estimated_time}s 完成")

# 轮询等待结果
while True:
    status = client.tasks.get(task.id)
    if status.status == "completed":
        print(f"视频已生成: {status.video_url}")
        break
    elif status.status == "failed":
        print(f"生成失败: {status.error.message}")
        break
    print(f"进度: {status.progress}%，预计还需 {status.estimated_remaining}s")
    time.sleep(10)

Node.js

import SeeAny from "seeany";

const client = new SeeAny({ apiKey: "sk-xxxxx" });

const task = await client.videos.generate({
  model: "kling-v3",
  prompt: "白色运动鞋在旋转展示台上缓慢旋转，studio灯光",
  duration: 5,
  resolution: "720p",
  webhookUrl: "https://your-app.com/webhook/video-complete",
});

console.log(`任务ID: ${task.id}，预计 ${task.estimatedTime}s 完成`);

// 等待结果
const result = await client.tasks.waitFor(task.id);
console.log(`视频URL: ${result.video_url}`);

cURL

# 创建任务
curl -X POST https://api.seeany.com/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxx" \
  -d '{
    "model": "kling-v3",
    "prompt": "白色运动鞋在旋转展示台上缓慢旋转，studio灯光",
    "duration": 5,
    "resolution": "720p",
    "audio": false
  }'

响应示例

{
  "id": "vid_20260603_001",
  "object": "video_generation",
  "status": "processing",
  "created": 1748908800,
  "model": "kling-v3",
  "estimated_time": 120,
  "params": {
    "prompt": "白色运动鞋在旋转展示台上缓慢旋转...",
    "duration": 5,
    "resolution": "720p",
    "audio": false
  }
}

计费说明

视频模型价格因模型和参数而异，详见 定价说明。

模型	5秒 720p 无声	10秒 720p 无声
可灵 Kling v3	¥3.50	¥5.00
Seedance 2.0	¥7.50	¥15.00
Sora 2	¥1.20	¥1.80

提示

• 视频生成通常需要 30 秒到 5 分钟
• 建议使用 Webhook 回调获取结果，避免频繁轮询
• audio=true 会增加生成时间和费用
• 资源 URL 有效期 7 天，请及时下载