- 引言
- 模型介绍
- 模型接口
- 模型查询相关
- 聊天(Chat)
- 图像(Images)
- 视频(Videos)
- OpenAI兼容接口
- Veo 3
- Sora-2
- 阿里通义千问
- 豆包(Doubao)
- 可灵AI(Kling)
- 即梦(Jimeng)
- 音频(Audio)
- 音乐(Music)
- 嵌入(Embeddings)
- 重排序 (Rerank)
- 审查(Moderations)
Sora-2（创建视频）
POST
v1/videos
prompt 支持精细化描述（时长、镜头、风格、氛围），是视频生成效果的核心控制项；
不同 Sora-2 版本对应不同的时长 / 分辨率上限，需匹配参数避免报错；
input_media 可传入参考素材，weight 参数控制素材参考程度，适合定制化场景；
异步场景建议配置 webhook_url，同步场景直接接收返回的视频 URL 即可。
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Body 参数application/json必填
示例
{
"model": "sora-2",
"prompt": "A realistic 1080p video of a surfer riding a wave at sunrise, ocean waves crash gently, golden light on the water, camera follows the surfer from behind, 30 seconds long, calm and peaceful atmosphere",
"duration": 30,
"resolution": "1080p",
"fps": 30,
"style_preset": "cinematic",
"aspect_ratio": "16:9",
"guidance_scale": 8.0,
"response_format": "mp4",
"num_variations": 1
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "sora-2",
"prompt": "A realistic 1080p video of a surfer riding a wave at sunrise, ocean waves crash gently, golden light on the water, camera follows the surfer from behind, 30 seconds long, calm and peaceful atmosphere",
"duration": 30,
"resolution": "1080p",
"fps": 30,
"style_preset": "cinematic",
"aspect_ratio": "16:9",
"guidance_scale": 8.0,
"response_format": "mp4",
"num_variations": 1
}'返回响应
🟢200成功
application/json
Body
示例
{
"id": "video-8e7b9c2d1a3f4e5d8b7a6c9e8b7d6a5f",
"object": "video.completion",
"created": 1735689600,
"model": "sora-2",
"status": "completed",
"data": [
{
"video_id": "vid-1234567890abcdef",
"url": "https://oaidalleapiprodscus.blob.core.windows.net/private/org-xxxx/user-xxxx/video-8e7b9c2d1a3f4e5d8b7a6c9e8b7d6a5f.mp4?se=2026-02-13T08%3A00%3A00Z&sig=xxxx&sp=r&sr=b&sv=2021-08-06",
"expires_at": 1736899200,
"format": "mp4",
"metadata": {
"resolution": "1080p",
"duration": 30.0,
"fps": 30,
"aspect_ratio": "16:9",
"style_preset": "cinematic",
"camera_movement": "tracking",
"seed": 458921763,
"guidance_scale": 8.0
},
"size_bytes": 185423987,
"variation_index": 0
}
],
"usage": {
"prompt_tokens": 128,
"video_tokens": 45600,
"total_tokens": 45728,
"duration_seconds_billed": 30
},
"metadata": {
"prompt": "A realistic 1080p video of a surfer riding a wave at sunrise, ocean waves crash gently, golden light on the water, camera follows the surfer from behind, 30 seconds long, calm and peaceful atmosphere",
"generation_time_seconds": 45.2,
"model_version": "sora-2-202601"
},
"error": null
}修改于 2026-03-16 14:55:01