Sora2 Pro 1080p API 调用示例

模型概览

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 调用示例Sora2 Pro 1080p 模型Sora2 Pro 1080p 价格Sora2 Pro 1080p 官方价格Sora2 Pro 1080p 计费Sora2 Pro 1080p 教程Sora2 Pro 1080p 接口文档sora2-pro-1080p APIsora2-pro-1080p 模型Sora2 Pro 1080p 视频模型Sora2 Pro 1080p 国内可用Sora2 Pro 1080p 海外可用Sora2 Pro 1080p API KeySora2 Pro 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/秒。实际费用以账户价格、套餐和最终结算为准。

官方入口

Sora2 Pro 1080p API查看 Sora2 Pro 1080p 的模型 ID、能力、价格和调用说明。AI智能体浏览 UniAll AI 的行业智能体、工作流、场景和自动化交付能力。AI模型库浏览 UniAll AI 已公开的图片、视频、文本和音频模型。API文档查看 OpenAI 兼容接口、任务查询、状态和错误码。模型价格查询模型价格、计费单位和成本估算入口。

Sora2 Pro 1080p API 调用示例：文生视频与图生视频接入教程