Skip to main content
该页面属于 Sora2 旧线路文档,目前已过时,仅供历史排查参考。当前可用入口请使用 Sora 官方 API 转发方案

视频生成相关

通过模型名控制,而不是参数。
  • 竖屏: sora_video2
  • 横屏: sora_video2-landscape
示例:
详见 模型与定价 页面。
水印策略以模型返回为准,可选带水印(10/18 新增)
  • 默认情况: 生成的视频水印策略以模型返回为准
  • 带水印选项: 在 URL 添加 ?watermark=true 生成带 Sora 原生水印的视频
水印策略以模型返回为准示例:
带水印示例:
官网生成的视频仍然带有 Sora 水印。选择 laozhang.ai 可以自由选择是否需要水印!
限制原因:
  1. 真实人脸参考图会被拒绝 - 不支持上传真人照片
  2. 仅支持授权真人 - 通过 @ID 方式使用
可用的授权真人:
  • @sama - OpenAI CEO Sam Altman
  • 其他已通过 Cameo 认证的用户
如何让真人出镜?需要在 Sora iOS 应用中完成 Cameo 认证:
  1. 使用美区 Apple ID 下载 Sora iOS 应用
  2. 在应用中进入设置
  3. 找到 Cameo 认证功能
  4. 按照指引完成人脸认证
  5. 认证后即可在提示词中使用 @您的ID
正确示例:
错误示例:
未经 Cameo 认证的真人照片会被 OpenAI 拒绝,这是平台政策,非 API 限制。
正常生成时间:
  • 排队:视高峰期而定
  • 生成:2-3 分钟
  • 总计:2.5-4 分钟
优化建议:
  1. 设置合理超时: 建议 5 分钟(300秒)
  1. 使用流式输出: 实时查看进度
  1. 避开高峰期: 选择使用人数较少的时段
原因: OpenAI 官方负载过高解决方案:
  1. 等待几分钟后重试
  2. 添加重试逻辑

API 调用相关

必需设置:令牌需要设置为按量优先按次计费模式。配置步骤:
  1. 登录 laozhang.ai 控制台
  2. 进入 API 管理
  3. 编辑令牌设置
  4. 选择”按量优先”或”按次计费”
令牌设置示例
如果未正确设置计费模式,调用会失败。
使用流式输出:
进度信息示例:
增加超时时间:
建议超时时间:
  • 最小:5 分钟(300秒)
  • 推荐:10 分钟(600秒)
图生视频支持:
  1. URL 图片
  1. Base64 编码
支持的格式:
  • PNG
  • JPEG/JPG
  • WebP
  • GIF(会使用第一帧)
限制:
  • 最多 1 张图片
  • 建议分辨率不超过 2048×2048

视频下载相关

有效期:仅 1 天
视频通过临时 CDN 链接返回,存储时效仅 1 天。请在生成后立即下载保存到本地!
最佳实践:
从响应中提取:
链接格式示例:
优化建议:
  1. 使用稳定网络 - 下载时建议保持连接稳定
  2. 流式下载 - 避免一次性加载到内存
  1. 断点续传 - 使用支持断点续传的下载工具

计费相关

计费方式: 按次计费计费口径:
  • 具体扣费以控制台订单和账单记录为准
  • 内容安全、超时、取消、异常状态按控制台记录处理
  • 如订单状态异常,请联系客服复核
价格(10/20 更新):
  • 10秒/15秒视频(竖屏/横屏):$0.15/次(统一定价)
  • 高清视频(sora-2-pro):$0.8/次(仅支持异步API
重大降价! 15秒模型已从 $0.25 降至 $0.15/次,与10秒模型同价。建议优先选择15秒版本获得更好效果!
推荐生产环境使用异步API:失败计费以控制台记录为准,成本更可控,稳定性更高。查看 异步API文档
关于内容违规扣费(仅同步API):如果提示词或图片违反 OpenAI 内容政策,同步API会返回成功(HTTP 200)但带错误信息,此时会扣费。原因:
  • 请求已成功提交到 OpenAI 平台
  • 平台已消耗资源进行内容审核
  • 异步API则计费以控制台记录为准(status = “failed”)
避免违规扣费的建议:
  1. 先在 sora.chatgpt.com 测试提示词和图片
  2. 确认通过后再通过 API 批量生成
  3. 或直接使用异步API(失败计费以控制台记录为准)
  4. 避免使用真人照片、版权内容
laozhang.ai vs OpenAI 官方:
OpenAI 官方已推出 sora-2sora-2-pro 模型,但价格高昂、有速率限制,且生成视频带水印。
登录 laozhang.ai 控制台,进入账单或调用日志页面查看。实际扣费以模型、请求结果和控制台实时价格为准。支付方式: 以控制台当前展示的可用方式为准。

高级功能

支持!基础模型稳定性极高基础模型(sora_video2 系列):
  • 稳定性:⭐⭐⭐⭐⭐ 极高
  • 建议并发数:30 以内
  • 大量并发需求(>50):可联系我们单独保障
高清模型(sora-2-pro):
  • 稳定性:⭐⭐⭐ 一般
  • 仅支持异步API调用
  • 不建议高并发使用
最佳实践:
联系我们:
10/20 新增功能当视频生成失败时,API 会返回详细的原始错误信息,帮助开发者和用户明确具体问题。错误类型示例:
  1. 内容违规(Content Violation)
  1. 服务过载(Heavy Load)
  1. 余额不足
如何处理错误:
有疑问欢迎联系我们交流:hi@laozhang.ai

客户端使用

配置步骤:
  1. 在 Cherry Studio 中添加 laozhang.ai API 配置
  2. 启用视频功能
    • 在模型设置中找到 sora_video2
    • 打开视频生成开关
  3. 使用
    • 文生视频:直接输入提示词
    • 图生视频:上传图片 + 提示词
已测试支持:
  • Cherry Studio ✓ - 完整支持,推荐使用
  • ChatBox ✓ - 支持
  • OpenWebUI ✓ - 支持
  • ChatGPT Next Web ✓ - 支持
任何兼容 OpenAI API 的客户端都可以使用配置方法:
  • API 端点:https://api2.laozhang.ai/v1
  • 模型:选择 sora_video2 系列

技术支持

联系方式:
  1. 邮箱: hi@laozhang.ai
  2. Telegram: https://t.me/laozhang_cn
  3. 文档: https://docs.laozhang.ai
提交问题时请提供:
  • 错误信息截图
  • 请求参数(隐藏 API Key)
  • 问题发生时间
  • 使用的模型名称
更新记录:
  • 10/07 新增 Python 示例代码
  • 10/01 上线 Sora 2 模型,支持文生视频和图生视频
查看完整更新:概览页面

最佳实践建议

提示词建议

  • ✓ 描述具体的场景和动作
  • ✓ 包含光线、氛围、情绪等细节
  • ✓ 使用授权真人 ID(如 @sama
  • ✗ 避免描述真实人脸
  • ✗ 避免过于简短的描述

模型选择建议

  • 推荐: sora_video2-15s / sora_video2-landscape-15s(与10秒同价,效果更好)
  • 竖屏视频:sora_video2 系列(手机短视频、社交媒体)
  • 横屏视频:sora_video2-landscape 系列(宽屏展示、电脑播放)
  • 高清需求:sora-2-pro(HD 1080P,$0.8/次,仅支持异步API
  • 基础模型稳定性都极高,可放心选择

错误处理建议

  • 设置合理超时(建议 5 分钟)
  • 添加重试逻辑(最多 2-3 次)
  • 使用流式输出监控进度
  • 记录错误日志

成本优化建议

  • 优先选择15秒版本(10/20 降价后与10秒同价)
  • 基础模型稳定性极高,减少重试成本
  • 批量生成时控制并发数(建议30以内)
  • 失败计费以控制台记录为准,可放心重试
  • 及时下载视频(存储时效 1 天)
  • 先用基础模型测试,再考虑高清版

相关链接

快速开始

查看示例代码和使用方法

模型定价

了解详细的模型对比和价格

使用示例

查看各种场景的应用示例

API 参考

查看完整的 API 文档