> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

# 🚧 Sora 简介 —— 服务不可用

<Warning>
  **Sora2 当前在 Mountsea 平台上不可用。** 相关接口（`/sora/video/generate`、`/sora/task/result`、`/sora/createRole`）将返回错误或在网关层被拒绝。以下文档仅作历史参考保留。

  **需要视频生成功能？** 请使用以下替代服务：

  * [Hub —— 优质 AI 网关](/zh/api-reference/hub/introduction) —— Veo 3.1、Kling v3、WAN 2.7、Seedance 2.0…（推荐）
  * [Gemini 视频（Veo 2 / 3 / 3.1）](/zh/api-reference/gemini/video-introduction)
  * [XAI (Grok) 视频](/zh/api-reference/xai/introduction)
</Warning>

欢迎使用 **Sora** 服务文档！

本服务曾经集成 **Sora AI**，即 OpenAI 的文生视频模型。Sora2 服务目前在 Mountsea **已下线**，请使用上方列出的视频生成替代服务。

## 功能特性

**Sora AI** 提供先进的视频生成能力，助力您的创意工作：

* **文生视频**：使用强大的 **Sora-2** 模型，通过文本提示创建高质量视频。只需描述您想看到的内容，Sora 就会生成将您的创意变为现实的视频。
* **灵活的视频格式**：生成不同方向（横屏或竖屏）和尺寸（小或大）的视频，以满足您的特定需求。
* **可自定义时长**：创建 10 秒或 15 秒时长的视频，让您掌控内容长度。
* **图生视频**：使用参考图片引导视频生成，创建更精确、更贴合上下文的内容。
* **水印控制**：选择是否在生成的视频中包含或去除水印。
* **任务管理**：跟踪和监控视频生成任务的状态，确保处理流程顺畅。

## 如何使用 Sora

要开始使用 **Sora**，请按照以下简单步骤操作：

1. **创建视频生成任务**：使用您的文本提示和所需参数创建任务。
2. **跟踪任务状态**：监控任务进度，了解视频何时可以下载。
3. **下载和使用**：任务完成后，您可以下载生成的视频用于您的项目。

## 可用端点

以下是与 **Sora** 交互的 API 端点：

### **视频生成 API**

* **使用 Sora-2 模型生成视频**
  `POST /sora/video/generate`
  使用 **Sora-2** 模型创建视频。提供描述您想要生成的视频的文本提示，以及方向、尺寸、时长和参考图片等可选参数。

* **获取任务结果**
  `GET /sora/task/result`
  获取视频生成任务的当前状态和结果。检查视频是否已准备好下载或是否有任何错误。

***

### 浏览 API 文档

有关如何使用这些端点的详细文档，请点击以下链接：

* [使用 Sora-2 模型生成视频](video)
* [获取任务结果](task)

***

## 关键参数

使用 Sora 生成视频时，您可以自定义以下重要参数：

* **Prompt**：视频的详细文本描述（最多 5000 个字符）
* **Model**：目前支持 `sora-2`（默认）
* **Orientation**：选择 `landscape`（默认，横屏）或 `portrait`（竖屏）
* **Size**：选择 `small`（默认）或 `large`，对应不同的视频尺寸
* **Duration**：设置为 `10`（默认）或 `15` 秒
* **Images**：可选的参考图片 URL 数组，用于引导视频生成
* **Remove Watermark**：布尔标志，控制水印是否显示（默认：false）

## 最佳实践

为了从 Sora 获得最佳效果：

1. **编写详细的提示词**：在文本提示中具体而详细地描述，以获得更准确的结果
2. **使用参考图片**：如有可用的参考图片，可提供它来引导视频生成
3. **选择合适的设置**：根据预期用途选择合适的方向和尺寸
4. **监控任务状态**：定期检查任务状态以确保成功完成
5. **优雅地处理错误**：为失败的任务实现适当的错误处理

***

更多详情，请访问完整的 [Sora API 文档](sora)。