当前位置：首页 > news >正文

Sora 视频生成 API 集成教程

news 2026/4/30 19:05:52

在本教程中，我们将手把手讲解如何在Ace Data Cloud平台上使用Sora 视频生成 API，实现输入文本和参考图片生成视频的功能。Sora 视频生成 API 支持两种版本模式：经典模式（Version 1）和合作伙伴模式（Version 2），适合不同场景的短视频创作。

Ace Data Cloud 是一个专业的云数据与 AI 开发平台，提供视频、图像、文本生成等多种 AI 服务。通过 Sora 视频生成 API，你可以快速将创意转化为视频，用于社交媒体、内容创作或原型展示等场景。

环境准备 / 前置条件

注册并登录 Ace Data Cloud 平台：注册入口
获取 Sora 视频生成 API 的访问权限：API 文档
安装 Python 或 Node.js，确保可以发送 HTTP 请求。
获取 API Key，用于在请求中进行授权。

申请 Sora 视频生成 API

打开 Sora 视频生成 API 页面。
点击页面中的“Acquire”按钮申请服务：

初次申请会获得一定的免费额度，方便测试使用。

Version 1（经典模式）基础使用

参数说明

model: 视频生成模型，sora-2（标准）或sora-2-pro（高清，支持 25 秒视频）
size: 视频分辨率，small（标准）、large（高清，仅 V1）
duration: 视频长度（秒），支持 10/15/25（25 秒仅sora-2-pro）
orientation: 视频方向，landscape/portrait
image_urls: 参考图片数组，用于图生视频
character_url: 角色生成视频 URL（禁止使用真人）
prompt: 视频生成文本提示（必填）
callback_url: 异步回调 URL
version: API 版本"1.0"（默认）

Python 示例

import requests url = "https://api.acedata.cloud/sora/videos" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "size": "large", "duration": 15, "orientation": "landscape", "prompt": "cat running on the river", "model": "sora-2" } response = requests.post(url, json=payload, headers=headers) print(response.text)

返回示例：

{ "success": true, "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33", "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01", "data": [ { "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh", "video_url": "https://filesystem.site/gptimage/...", "state": "succeeded" } ] }

只需使用data.video_url就能访问生成的视频。

图生视频示例（Version 1）

payload = { "size": "large", "duration": 15, "orientation": "landscape", "prompt": "cat running on the river", "model": "sora-2", "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"] }

执行后即可生成基于参考图片的视频。

角色生成视频示例（Version 1）

payload = { "size": "small", "duration": 10, "orientation": "landscape", "prompt": "cat running on the river", "character_url": "https://cdn.acedata.cloud/pdidf5.mp4", "model": "sora-2", "character_start": 1, "character_end": 3 }

注意：视频中禁止出现真人，否则任务会失败。

Version 2（合作伙伴模式）

Version 2 支持更短的视频和像素级分辨率控制。

参数	说明
`version`	设置为`"2.0"`
`prompt`	文本提示，必填
`model`	可选，默认`sora-2`
`duration`	视频长度：4、8、12 秒
`size`	分辨率：`720x1280`、`1280x720`、`1024x1792`、`1792x1024`
`image_urls`	参考图片数组，仅使用第一张
`callback_url`	异步回调 URL

Python 示例

payload = { "version": "2.0", "prompt": "a person walking through a beautiful garden", "model": "sora-2", "duration": 4, "size": "1280x720", "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"] }

返回结果与 V1 格式相同。