跳转到主要内容
**寻找更稳定的方案？**本页面介绍 同步 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 
curl -X POST "https://api.yelinai.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "@sama 在八达岭长城上的背景，开心地口述：YeLIn AI的客户朋友们，国庆中秋佳节，玩得愉快！"
          }
        ]
      }
    ]
  }'

​
图生视频示例

支持上传参考图片（最多 1 张），支持 URL 和 Base64 两种方式。 cURL (URL) Python (URL) cURL (Base64) 
curl -X POST "https://api.yelinai.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "生成视频：让这个手办形象从桌子上跳出来，变成活人的一个场景~"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://filesystem.site/cdn/download/20250407/OhFd8JofOAJCsNOCsM1Y794qnkNO3L.png"
            }
          }
        ]
      }
    ]
  }'

​
流式输出示例

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

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yelinai.com/v1"
)

stream = client.chat.completions.create(
    model="sora_video2",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "一只可爱的猫咪在阳光明媚的花园里玩球"
                }
            ]
        }
    ],
    stream=True
)

# 存储完整内容以提取视频链接
full_content = ""

print("生成进度:\n")
for chunk in stream:
    if chunk.choices[0].delta.content:
        content = chunk.choices[0].delta.content
        print(content, end='', flush=True)
        full_content += content

print("\n")

# 提取视频链接
video_url_match = re.search(r'https://[^\s\)]+\.mp4', full_content)
if video_url_match:
    video_url = video_url_match.group(0)
    print(f"\n✅ 视频链接: {video_url}")
    print("⚠️  视频有效期1天，请立即下载！")
else:
    print("\n❌ 未找到视频链接，生成可能失败")

​
输出解读

​
流式输出格式

启用 "stream": true 时，API 返回 SSE（Server-Sent Events）格式： 
data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"```json\n{\n    \"prompt\": \"A happy cat playing with a ball in a sunny garden\",\n    \"mode\": \"竖屏模式\"\n}\n```\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> ⌛️ 任务正在队列中，请耐心等待...\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> 🏃 进度：36.0%\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{"content":"> ✅ 视频生成成功，[点击这里](https://sora.gptkey.asia/assets/sora/xxx.mp4) 查看视频~~~\n\n"},"finish_reason":null}]}

data: {"id":"foaicmpl-xxx","object":"chat.completion.chunk","created":1759759480,"model":"sora_video2","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":17,"completion_tokens":244,"total_tokens":261}}

data: [DONE]

​
关键字段说明

  • 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 (带水印) 
curl -X POST "https://api.yelinai.com/v1/chat/completions?watermark=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "一只可爱的猫咪在阳光明媚的花园里玩球"
          }
        ]
      }
    ]
  }'
使用场景：
  • 默认无水印：适合商业使用、品牌宣传等需要无水印的场景
  • 带水印：适合测试、学习、展示 Sora 生成效果等场景

​
视频下载

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

​
下一步

​
模型定价

了解不同模型的详细对比

​
更多示例

查看 Cherry Studio 等场景应用

​
常见问题

解决使用中的问题

​
API 参考

查看完整的 API 文档