模型概览
Sora2 Pro 1080p 是 UniAll AI 平台提供的视频生成模型,public model id 为 `sora2-pro-1080p`。它适合生成电影感短片、产品展示视频、电商素材、广告分镜和社媒竖屏/横屏内容。
核心能力:
- **文生视频**:只输入 prompt,即可生成视频。
- **图生视频**:上传或传入一张参考图 URL,让模型基于画面生成动态视频。
- **异步任务**:视频生成耗时较长,接口以异步任务方式处理。
- **分辨率可选**:`720p`、`1080p`、`true_1080p`。
- **时长可选**:4、8、12、16、20 秒。
- **画幅可选**:`16:9` 横屏或 `9:16` 竖屏。
> 注意:当前每次生成固定输出 1 个视频,即 `video_count: 1`。
适合谁使用?
Sora2 Pro 1080p 更适合需要稳定接入视频生成能力的开发者和团队,例如:
- 短视频工具、AI 创作平台、素材站开发者
- 电商、广告、品牌营销团队
- 需要自动化批量生成视频素材的运营团队
- 需要把文生视频或图生视频能力集成到 SaaS、分站或代理系统的企业
如果只是快速预览成本或效果,可以先用 `720p`;如果用于正式素材交付,通常选择 `1080p`;对清晰度要求更高时可选择 `true_1080p`。
API 基本信息
- 请求方式:`POST`
- Endpoint:`/v1/videos/generations`
- 模型 ID:`sora2-pro-1080p`
- 任务类型:异步
- 必填参数:`prompt`、`duration`、`resolution`、`aspect_ratio`
- 模式参数:`generation_mode`
支持的生成模式:
| 模式 | generation_mode | 必填参数 | |---|---|---| | 文生视频 | `text_to_video` | `prompt` | | 图生视频 | `reference_image_to_video` | `prompt`, `image_url` |
参数说明
| 参数 | 类型 | 示例 | 说明 | |---|---|---|---| | `model` | string | `sora2-pro-1080p` | public model id | | `generation_mode` | string | `text_to_video` | 文生视频或图生视频模式 | | `prompt` | string | `A cinematic product reveal...` | 视频描述词 | | `image_url` | string | `https://example.com/ref.png` | 图生视频参考图,仅图生视频需要 | | `duration` | integer | `4` | 支持 4/8/12/16/20 秒 | | `aspect_ratio` | string | `16:9` | 支持 `16:9`、`9:16` | | `resolution` | string | `1080p` | 支持 `720p`、`1080p`、`true_1080p` | | `video_count` | integer | `1` | 当前固定为 1 |
示例一:curl 调用文生视频
```bash curl -X POST "https://api.uniall.ai/v1/videos/generations" \ -H "Authorization: Bearer $UNIALL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sora2-pro-1080p", "generation_mode": "text_to_video", "prompt": "A cinematic product reveal of a premium smartwatch on a dark reflective surface, soft studio lighting, slow camera dolly, high detail.", "duration": 4, "aspect_ratio": "16:9", "resolution": "1080p", "video_count": 1 }' ```
示例二:curl 调用图生视频
```bash curl -X POST "https://api.uniall.ai/v1/videos/generations" \ -H "Authorization: Bearer $UNIALL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sora2-pro-1080p", "generation_mode": "reference_image_to_video", "prompt": "Animate this product photo into a clean commercial video, subtle camera movement, elegant lighting, no text overlay.", "image_url": "https://example.com/reference.png", "duration": 4, "aspect_ratio": "16:9", "resolution": "1080p", "video_count": 1 }' ```
参考图建议使用 PNG、JPEG 或 WebP,并确保图片 URL 可被服务端访问。
示例三:Node.js 调用
```js const API_KEY = process.env.UNIALL_API_KEY;
async function createVideo() { const response = await fetch("https://api.uniall.ai/v1/videos/generations", { method: "POST", headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ model: "sora2-pro-1080p", generation_mode: "text_to_video", prompt: "A vertical fashion campaign video, model walking through a minimal studio, cinematic lighting, smooth motion.", duration: 8, aspect_ratio: "9:16", resolution: "1080p", video_count: 1 }) });
if (!response.ok) { const errorText = await response.text(); throw new Error(`Video generation failed: ${response.status} ${errorText}`); }
const result = await response.json(); console.log(result); }
createVideo().catch(console.error); ```
接口为异步生成,实际返回中通常会包含任务标识或状态信息。请根据 UniAll AI 控制台或接口返回字段查询任务进度与最终视频地址。
Prompt 编写建议
为了提高生成稳定性,建议 prompt 包含以下信息:
1. **主体**:产品、人物、场景或动作。 2. **镜头语言**:slow dolly、close-up、tracking shot、aerial view 等。 3. **风格**:cinematic、commercial、documentary、minimal studio 等。 4. **光线与画面**:soft lighting、high detail、shallow depth of field。 5. **限制项**:如 no text overlay、no logo distortion、stable composition。
示例:
```text A cinematic 9:16 commercial video of a perfume bottle on wet black stone, slow camera push-in, soft reflections, luxury mood, high detail, no text overlay. ```
价格与计费角度
Sora2 Pro 1080p 按视频秒数计费,不同分辨率单价不同。以当前 UniAll AI 页面展示价格为例:
| 分辨率 | 页面参考价 | |---|---:| | 720p | ¥1.47 / 秒 | | 1080p | ¥2.45 / 秒 | | True 1080p | ¥3.43 / 秒 |
示例:生成一条 4 秒 1080p 视频,预估费用约为 `4 × ¥2.45 = ¥9.80`。实际扣费以账户、套餐、API 价格配置和平台结算结果为准。
平台支持失败退款;当前模型不默认自动重试,业务侧可根据错误类型自行设计重试策略。
接入建议
- **先低成本验证**:用 4 秒、720p 测试 prompt 和画面方向。
- **正式素材再升分辨率**:确认效果后切换到 1080p 或 true_1080p。
- **队列化处理**:视频生成是异步任务,建议使用任务队列、状态轮询和回调机制管理并发。
- **保存请求参数**:记录 prompt、resolution、duration 和返回任务 ID,便于排查失败或复现效果。
- **图生视频检查 URL**:确保 `image_url` 可公网访问,格式为 PNG/JPEG/WebP。
小结
如果你要在产品中接入高清 AI 视频生成,`sora2-pro-1080p` 是一个面向文生视频和图生视频的实用选择。它的参数结构清晰,支持横屏和竖屏,适合短视频、广告、电商和内容平台工作流。开发者可以从 4 秒 720p 测试开始,再根据业务需求切换到 1080p 或 True 1080p。
常见问题
Sora2 Pro 1080p API 如何调用?
在 UniAll AI 中向 /v1/videos/generations 发起 POST 请求,设置 model 为 sora2-pro-1080p,并传入 prompt、duration、aspect_ratio、resolution 等参数。文生视频使用 generation_mode: text_to_video,图生视频使用 generation_mode: reference_image_to_video 并额外传入 image_url。
Sora2 Pro 1080p 支持哪些分辨率和时长?
支持 720p、1080p、true_1080p 三种分辨率;视频时长支持 4、8、12、16、20 秒。画幅支持 16:9 横屏和 9:16 竖屏。
Sora2 Pro 1080p 怎么收费?
该模型按秒计费,不同分辨率单价不同。页面参考价为 720p ¥1.47/秒、1080p ¥2.45/秒、True 1080p ¥3.43/秒。实际费用以账户价格、套餐和最终结算为准。