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

# Sora 2 视频 API 已下线：迁移到 Wan 2.7 或 Seedance 2.0

> Sora 2 视频 API（sora-2、sora-2-pro）下线的依据、已生成视频的处理方式，以及如何迁移到 Wan 2.7 或 Seedance 2.0。

`sora-2` 和 `sora-2-pro` 已下线，不能用于新的视频生成请求。仍在调用 Sora 2 的集成，请迁移到 [Wan 2.7](/api-capabilities/wan-video-generation) 或 [Seedance 2.0](/api-capabilities/seedance2-video-generation)。

发布日期：**2026 年 9 月 24 日** · 最后核对：**2026 年 9 月 24 日** · 当前状态：**已下线**

## 下线事实

| 项目 | 内容 |
| - | - |
| 受影响模型 ID | `sora-2`、`sora-2-pro` |
| 受影响端点 | 以上述模型发起的 `POST /v1/videos`、`GET /v1/videos/{id}`、`GET /v1/videos/{id}/content` |
| 老张API | 2026 年 6 月 17 日公告：自 2026 年 7 月 1 日起停止维护并下线 Sora 2 的官方 API 转发（官转）线路 |
| OpenAI | 2026 年 9 月 24 日从 API 移除 Videos API、`sora-2`、`sora-2-pro` 及其快照，没有替代模型 |
| 替代方案 | Wan 2.7 或 Seedance 2.0 |

## 影响范围

受影响的集成：

* 请求中仍传 `model: "sora-2"` 或 `model: "sora-2-pro"` 的代码、任务队列和定时任务；
* 使用 `Sora2Official` 或 `GPTImage2 Sora2 Enterprise` 分组的令牌、通过 `/v1/videos` 生成 Sora 2 视频的服务；
* 通过 OpenAI SDK 的 `videos` 资源（例如 `client.videos.create`）调用 Sora 2 的项目，无论 Base URL 指向老张API还是 OpenAI；
* 更早的 Sora 2 旧线路（同步接口、异步队列和角色创建）。它们此前就已不再作为接入入口，也不能用来替代官转。

不受影响：

* Wan 2.7、Seedance 2.0 视频生成；
* `Sora2Official`、`GPTImage2 Sora2 Enterprise` 分组下的图像模型，例如官转 `gpt-image-2`。本次下线只涉及 Sora 2 视频模型，图像调用按各自的接入文档使用。

## 需要执行的操作

1. **停止提交新的 Sora 2 任务。** 从代码、任务队列和定时任务中移除 `sora-2`、`sora-2-pro`，同时关闭针对这些请求的自动重试。
2. **立即保存已生成的视频。** 如果还有已完成但没有下载的任务，请马上尝试下载并转存到自己的存储。

   OpenAI 的视频下载链接有效期很短，Videos API 移除后，这些结果可能已经无法取回；下载失败的视频只能用新模型重新生成。
3. **迁移到 Wan 2.7 或 Seedance 2.0。** 按下一节选择模型并改写请求。先用少量任务确认画面、时长和扣费，再切换生产流量。
4. **清理令牌分组配置。**
   * 只为 Sora 2 创建的令牌，可以在[令牌管理](https://api.laozhang.ai/token)中停用或删除。
   * 如果同一令牌还在调用 `Sora2Official` 或 `GPTImage2 Sora2 Enterprise` 分组的图像模型，请保留令牌，只移除其中的 Sora 2 调用。
   * 迁移后，为 Wan 2.7 和 Seedance 2.0 分别创建令牌，分组选择 `Wan` 或 `SeeDance2`。

## 迁移到 Wan 2.7 或 Seedance 2.0

两者都采用异步任务：先创建任务，再轮询状态，最后下载 MP4。但它们的接口路径、请求结构和计费方式都与 Sora 2 不同，只替换 `model` 字段无法完成迁移。

| 对比项 | Wan 2.7 | Seedance 2.0 |
| - | - | - |
| 模型 ID | `wan2.7-t2v`、`wan2.7-i2v`、`wan2.7-r2v`、`wan2.7-videoedit` | `doubao-seedance-2-0-260128`、`doubao-seedance-2-0-fast-260128`、`doubao-seedance-2-0-mini-260615`、`doubao-seedance-2-5-260628` |
| 令牌分组 | 必须用 `Wan`，计费模式选按量优先或按量计费 | 必须用 `SeeDance2`，计费模式选按量优先或按量计费 |
| 任务类型 | 文生视频、首帧图生视频（可配驱动音频）、参考图生视频、视频编辑，按任务类型选模型 | 文生视频、首尾帧，以及图片、视频、音频多模态参考，统一放在 `content` 数组 |
| 计费方式 | 按秒计费：720P \$0.09/秒，1080P \$0.15/秒 | 按 token 计费，每个任务有预扣和结算两条日志 |
| 结果获取 | 查询结果中的 `result_url`，24 小时内下载 | `content.video_url`（通常 24 小时内有效），或兼容下载接口 |
| 接入文档 | [Wan 2.7 视频生成 API](/api-capabilities/wan-video-generation) | [Seedance 2.0 视频生成 API](/api-capabilities/seedance2-video-generation) |

两者的美元单价、与官方价的换算方法和单任务估算，见两个接入文档的「计费与价格」一节（依据 2026 年 9 月 24 日公开价格配置）；每个任务的实际扣费以[调用日志](https://api.laozhang.ai/log)为准。

### 请求字段对照

| Sora 2 | Wan 2.7 | Seedance 2.0 |
| - | - | - |
| `prompt` | `input.prompt` | `content[]` 中 `type: "text"` 项的 `text` |
| `seconds`（字符串） | `parameters.duration`（整数） | `duration`（整数） |
| `size` | `parameters.resolution`，例如 `720P` | `ratio`（例如 `16:9`）和 `resolution`（例如 `720p`） |
| `input_reference`（上传文件） | 使用 `wan2.7-i2v`，在 `input.media[]` 中传 `first_frame` 图片链接 | 在 `content[]` 中传 `role: "first_frame"` 的图片 URL |
| `/v1/videos/{id}/content` 下载 | 下载 `result_url`，不带鉴权头 | 下载 `content.video_url`，或调用 `/v1/videos/{id}/content` |

改写时还要注意：

* 两者都使用 JSON 请求体，图片、视频等素材以公网可访问的 HTTPS 链接传入，不再以 multipart 上传文件。
* Wan 2.7 创建任务时必须带 `X-DashScope-Async: enable` 请求头；Seedance 2.0 的 Base URL 必须包含 `/seedance/api/v3` 前缀。
* 时长的取值范围按目标模型设置，例如 `wan2.7-t2v` 为 2–15 秒的整数，Seedance 2.0 为 4–15 秒。
* 状态值不同，轮询代码需要按目标文档改写，两者的状态值见下表。

| 阶段 | Wan 2.7（顶层 `status`） | Seedance 2.0 |
| - | - | - |
| 排队 | `submitted` | `queued` |
| 生成中 | `in_progress` | `running` |
| 成功 | `completed` | `succeeded`（兼容对象中为 `completed`） |
| 失败 | `failed` | `failed` |
| 过期 | — | `expired` |

## 常见问题

### 价格配置里还能看到 `sora-2`，还能调用吗？

不能用于新请求。2026 年 9 月 24 日的公开价格配置中暂时还保留着 `sora-2`、`sora-2-pro` 的条目，但老张API自 2026 年 7 月 1 日起已停止维护 Sora 2 官转线路，OpenAI 也已从 API 中移除这两个模型。请以本页状态为准，改用 Wan 2.7 或 Seedance 2.0。

### 已经生成的 Sora 2 视频还能下载吗？

不能保证。OpenAI 的视频下载链接有效期很短，Videos API 移除后，未保存的结果可能已经无法取回。请立即尝试下载并转存；如果下载失败，只能用 Wan 2.7 或 Seedance 2.0 重新生成。

### Wan 2.7 和 Seedance 2.0 怎么选？

两者都能完成文生视频和首帧图生视频，差别在任务拆分方式和素材组合。

* **Wan 2.7**：按任务类型拆分为文生、图生、参考图生和视频编辑四个模型，图生视频可以配驱动音频。
* **Seedance 2.0**：在一个 `content` 数组中组合文本、图片、视频和音频参考，支持首尾帧，并可引用[真人与虚拟人素材](/api-capabilities/seedance2-human-virtual-workflow)。

建议用同一组提示词各跑少量任务，对比画面、时长和调用日志中的扣费后再决定。

### 为什么不能只把 `model` 改成新模型名？

因为接口本身不同。Wan 2.7 使用 DashScope 兼容路径，并要求 `X-DashScope-Async: enable`；Seedance 2.0 使用 `/seedance/api/v3` 下的火山方舟兼容路径。两者的请求体结构、状态值和结果下载方式也与 Sora 2 不同。

此外，新模型要使用 `Wan` 或 `SeeDance2` 分组的令牌，原来用于 Sora 2 的令牌分组并不适用。

### Sora 2 旧线路或角色创建还能用吗？

不能作为替代方案。旧线路的同步接口、异步队列和角色创建此前就已不再作为接入入口，相关文档作为历史存档列在下方「旧线路历史文档」一节，其中的示例已无法调用。需要继续生成视频时，请迁移到 Wan 2.7 或 Seedance 2.0。

## 旧线路历史文档

下面是更早的 Sora 2 旧线路（`sora_video2` 系列模型、异步任务队列和角色创建）的文档存档，只供已有集成查阅，其中的示例已无法调用。

* [Sora 2 视频生成 API 总览](/api-capabilities/sora2/overview)：旧线路的模型、调用方式和更新记录。
* [Sora 2 模型与定价](/api-capabilities/sora2/models-pricing)：`sora_video2` 系列、`sora-2-pro` 和角色创建的规格与历史价格。
* [Sora 2 同步 API 快速开始](/api-capabilities/sora2/quick-start)：通过 `/v1/chat/completions` 文生视频、图生视频和流式输出。
* [Sora 2 API 参考](/api-capabilities/sora2/api-reference)：同步接口的请求参数、响应格式和错误码。
* [Sora 2 异步调用 API](/api-capabilities/sora2/async-api)：通过 `/v1/videos` 创建任务、查询状态和下载视频。
* [Sora 2 角色创建 API](/api-capabilities/sora2/character)：从视频中提取角色，并在提示词中用 `@username` 复用。
* [Sora 2 使用示例](/api-capabilities/sora2/examples)：Python、Node.js、Cherry Studio 和批量生成示例。
* [Sora 2 常见问题](/api-capabilities/sora2/troubleshooting)：旧线路的横竖屏、水印、超时、下载和计费问题。

## 来源与相关链接

* **老张API公告**：[2026 年公告归档](/announcements/changelog-archive-2026)中 2026 年 6 月 17 日的 Sora 2 官转线路下线通知；最新状态见[网站公告](/changelog)。
* **OpenAI 官方**：[OpenAI 弃用页](https://developers.openai.com/api/docs/deprecations)。OpenAI 于 2026 年 3 月 24 日发出通知，2026 年 9 月 24 日从 API 移除以下内容，没有推荐替代模型：
  * Videos API
  * 模型 `sora-2`、`sora-2-pro`
  * 快照 `sora-2-2025-10-06`、`sora-2-2025-12-08`、`sora-2-pro-2025-10-06`
* **迁移文档**：[Wan 2.7 视频生成 API](/api-capabilities/wan-video-generation)、[Seedance 2.0 视频生成 API](/api-capabilities/seedance2-video-generation)、[Seedance 真人与虚拟人素材 API](/api-capabilities/seedance2-human-virtual-workflow)。
* **控制台与计费**：[令牌管理](https://api.laozhang.ai/token)、[模型价格](https://api.laozhang.ai/account/pricing)、[调用日志](https://api.laozhang.ai/log)、[模型与价格总表](/models)；服务与计费规则以[用户协议](https://www.laozhang.ai/zh-cn/terms)为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.