Skip to main content
**寻找更稳定的方案?**本页面介绍 同步 API(适合快速测试)。如需更稳定的生产环境方案,推荐使用异步 API

前置要求

1 获取 API Key 登录 YeLIn AI 控制台 获取 API 密钥 2 配置计费模式 编辑令牌设置,选择以下任一计费模式(两者价格相同):
  • 按量优先(推荐):优先使用余额计费,余额不足时自动切换。适合大多数用户
  • 按次计费:每次调用直接扣费。适合预算控制严格的场景
两种模式价格完全相同,都是 $0.15/次(10秒或15秒),仅扣费方式不同。
请在 Console 查看对应界面截图。
如果未设置计费模式,API调用会失败。必须先完成此配置!

文生视频示例

**关于示例中的 @sama**您可能注意到示例中使用了 @sama,这是 OpenAI CEO Sam Altman 的授权真人ID,可以让他的形象出现在视频中。这是可选功能
  • ✓ 可以使用 @sama 或其他已认证的真人ID
  • ✓ 也可以不使用,直接描述普通场景(如”一只猫在花园里”)
  • ✗ 不能上传真人照片(会被拒绝且扣费)
如何让你自己出镜? 需要在 Sora iOS 应用中完成 Cameo 认证。详见 常见问题 最简单的使用方式,仅使用文字描述生成视频。 cURL Python JavaScript

图生视频示例

支持上传参考图片(最多 1 张),支持 URL 和 Base64 两种方式。 cURL (URL) Python (URL) cURL (Base64)

流式输出示例

启用流式输出可以实时查看生成进度。 Python (流式) JavaScript (流式)

输出解读

流式输出格式

启用 "stream": true 时,API 返回 SSE(Server-Sent Events)格式:

关键字段说明

  • choices[0].delta.content: 包含进度信息或最终视频链接
  • finish_reason: 为 "stop" 时表示生成完成
  • usage: 最后一条消息包含 token 使用情况
  • 视频链接: 在成功消息中以 Markdown 链接形式提供

生成时间

  • 排队等待: 视高峰期而定
  • 视频生成: 约 2-3 分钟(10秒视频)
  • 总耗时: 通常在 2.5-4 分钟之间
设置超时时间时,建议不少于 5 分钟(300秒),以确保视频生成完成。

带水印视频生成

10/18 新增功能默认生成的视频无水印。如需生成带 Sora 原生水印的视频,在 URL 添加参数 ?watermark=true cURL (带水印) Python (带水印)
使用场景:
  • 默认无水印:适合商业使用、品牌宣传等需要无水印的场景
  • 带水印:适合测试、学习、展示 Sora 生成效果等场景

视频下载

1 获取视频链接 从 API 响应中提取视频 URL 2 立即下载 视频存储时效仅 1 天,请立即下载到本地 3 保存备份 建议保存到云存储或本地硬盘 视频存储在国内 CDN,国内用户访问速度快。但请注意及时下载,超过 1 天后链接将失效。

下一步

模型定价

了解不同模型的详细对比

更多示例

查看 Cherry Studio 等场景应用

常见问题

解决使用中的问题

API 参考

查看完整的 API 文档