Skip to main content
POST
/
v1
/
videos
/
generations
Sora2 视频生成
curl --request POST \
  --url https://ai.kaiho.cc/v1/videos/generations \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "model": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "fps": 123,
  "style": "<string>",
  "webhook_url": "<string>"
}'

​
概述

Sora2 是 OpenAI 的最新视频生成模型，能够根据文本描述创建逼真的视频内容，支持多种分辨率和时长。
异步任务： 视频生成是异步操作，需要使用任务管理 API 查询生成状态。

​
支持的模型

Sora2

OpenAI 最新视频生成模型

Sora Turbo

更快的生成速度

Runway Gen-3

高质量视频生成

Pika 1.5

创意视频生成

​
请求参数

​
prompt
string
required
视频描述文本，最多 500 个字符。详细描述场景、动作、镜头运动等。
​
model
string
default:"sora-2"
使用的模型：
  • sora-2 - 最新最强大
  • sora-turbo - 快速生成
  • runway-gen3 - 高质量
  • pika-1.5 - 创意风格
​
duration
integer
default:5
视频时长（秒），范围 2-20 秒。
​
resolution
string
default:"1280x720"
视频分辨率：
  • 1920x1080 - Full HD
  • 1280x720 - HD
  • 640x360 - SD
  • 1024x1024 - 方形（社交媒体）
​
fps
integer
default:24
帧率，可选值：24, 30, 60
​
style
string
视频风格：
  • realistic - 写实风格
  • cinematic - 电影风格
  • animated - 动画风格
  • artistic - 艺术风格
​
webhook_url
string
任务完成时的回调 URL（可选）。

​
请求示例

curl https://ai.kaiho.cc/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "sora-2",
    "prompt": "一只金毛犬在秋天的公园里追逐飘落的树叶，阳光透过树叶洒下，慢镜头，电影级画质",
    "duration": 10,
    "resolution": "1920x1080",
    "fps": 30,
    "style": "cinematic"
  }'

​
响应格式

创建任务时的响应： 
{
  "id": "task_abc123",
  "status": "pending",
  "created_at": "2024-01-15T10:30:00Z",
  "estimated_time": 120
}
任务完成后的状态： 
{
  "id": "task_abc123",
  "status": "completed",
  "progress": 100,
  "result": {
    "video_url": "https://storage.kaiho.cc/videos/video-123.mp4",
    "thumbnail_url": "https://storage.kaiho.cc/videos/thumb-123.jpg",
    "duration": 10,
    "resolution": "1920x1080",
    "size_bytes": 15728640
  },
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:32:30Z"
}

​
使用 Webhook

配置 webhook 以自动接收完成通知： 
response = requests.post(
    "https://ai.kaiho.cc/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "sora-2",
        "prompt": "视频描述...",
        "webhook_url": "https://your-server.com/webhook",
        "webhook_secret": "your_secret_key"  # 用于验证请求
    }
)
Webhook 回调格式： 
{
  "event": "video.completed",
  "task_id": "task_abc123",
  "status": "completed",
  "result": {
    "video_url": "https://storage.kaiho.cc/videos/video-123.mp4",
    "duration": 10
  }
}

​
提示词最佳实践

包含环境、光线、天气、时间等细节描述。示例：“日落时分的海滩，金色的阳光洒在波光粼粼的海面上”
描述相机运动方式以获得更好的效果。示例：“缓慢推进镜头”、“环绕拍摄”、“鸟瞰视角”
清楚描述主体的动作和表情。示例：“一个小女孩开心地奔跑，笑容灿烂”
引用知名导演或电影风格。示例：“韦斯·安德森对称构图风格”、“诺兰式的史诗感”

​
提示词模板

  • 自然风光
  • 人物特写
  • 产品展示
[场景]: 壮丽的山景
[时间]: 日出时分
[光线]: 金色晨光穿透云层
[镜头]: 无人机缓慢上升拍摄
[风格]: 纪录片级别，BBC地球脉动风格

​
生成时间估算

时长分辨率预计时间
5秒720p1-2 分钟
5秒1080p2-3 分钟
10秒720p3-5 分钟
10秒1080p5-8 分钟
20秒1080p10-15 分钟
节省时间： 在测试提示词时，先使用较低分辨率和较短时长，确定效果后再生成高质量版本。

​
内容限制

  • ❌ 暴力血腥内容
  • ❌ 成人内容
  • ❌ 侵权内容
  • ❌ 误导性深度伪造
  • ✅ 创意内容
  • ✅ 教育内容
  • ✅ 营销视频
存储时间： 生成的视频保存 7 天，请及时下载。
⌘I