Skip to content

lyzcodebool/sora-2-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 

Repository files navigation

三步对接 Sora-2:轻松调用 OpenAI 最新视频模型

OpenAI 最新视频模型 Sora-2 已正式开放调用,其支持通过 Chat 格式直接生成指定参数的视频内容(如竖屏/横屏、时长、清晰度),极大降低了视频生成技术的使用门槛。本文将结合“极速API”中转平台(BaseURL:https://api.jisuai.top/) 为你详细拆解三步对接流程,助你快速实现 Sora-2 模型调用。

Tip

🌟 推荐API中转平台(本项目完美适配)

急速AI - 稳定可靠的AI API中转服务

  • 🔗 官方地址https://api.jisuai.top
  • 核心优势:高速稳定、多模型支持、价格优惠、无需科学上网
  • 🔑 使用方法:注册获取API密钥 → 管理面板添加令牌 → 立即开始使用
  • 🛡️ 推荐理由:专业的API中转服务,完美解决直连限制问题
  • 🎯 支持模型:OpenAI GPT、Claude、Midjourney等主流AI模型

第一步:明确对接核心前提与参数

在开始对接前,需先确认关键信息与准备工作,避免因参数缺失或格式错误导致调用失败:

  1. 核心基础信息

    • BaseURL:固定为极速API提供的地址 https://api.jisuai.top/(该平台兼容 OpenAI 格式,无需额外适配复杂接口)。
    • 模型名称:需在请求参数中指定 model: "sora-2"(区分于其他文本模型,确保调用的是最新视频模型)。
    • 认证密钥:需先在极速API平台完成在线充值(平台支持按量计费、无隐藏消费),获取专属 Bearer Token(示例中为 sk-Uk,实际需替换为个人密钥)。
  2. 视频参数规则
    Sora-2 支持在用户提示词中直接指定视频属性,格式为“(参数1, 参数2, 参数3...)”,核心参数包括:

    • 画面比例:竖屏(适配移动端)、横屏(适配PC/电视端);
    • 时长:15s(默认)、30s60s(需注意时长越长,计费成本越高);
    • 清晰度:高清(720P)、超清(1080P)、4K(需确认平台是否支持)。

第二步:编写 Sora-2 调用代码(基于 OpenAI 格式)

极速API平台兼容 OpenAI 的 v1/chat/completions 接口格式,仅需替换 modelmessages 内容即可,以下为完整代码示例(以 curl 命令为例,其他编程语言可参考此逻辑适配):

curl --location -g --request POST 'https://api.jisuai.top/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer sk-Uk' \  # 替换为你的实际密钥
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "sora-2",  # 指定调用 Sora-2 视频模型
    "messages": [
      {
        "role": "system",
        "content": "You are a professional video generation assistant. Generate videos strictly according to the user'\''s parameter requirements."  # 系统提示:明确模型生成视频的职责
      },
      {
        "role": "user",
        "content": "(竖屏,15s,高清)生成一段猫咪在阳台晒太阳的温馨场景,画面需明亮、色彩柔和,伴有轻微的鸟鸣背景音"  # 用户提示:包含视频参数+内容描述
      }
    ]
  }'

代码关键说明:

  • 接口路径:固定为 /v1/chat/completions,与 OpenAI 标准路径一致,无需修改;
  • messages 结构system 角色用于定义模型行为(确保生成视频而非文本),user 角色需同时包含“视频参数”与“内容描述”,两者缺一不可;
  • 格式兼容性:若需使用 Python、Java 等语言调用,可将上述 curl 命令转换为对应 HTTP 请求代码(例如 Python 使用 requests 库,核心参数与 header 保持一致)。

第三步:测试调用与查看结果

完成代码编写后,通过以下步骤验证对接是否成功,并获取生成的视频:

  1. 发送请求
    将上述 curl 命令复制到终端(或使用 Apifox、Postman 等工具),替换 Authorization 中的密钥后执行。极速API平台标注“极速响应”,通常可在几秒内返回请求结果(具体耗时取决于视频时长与清晰度)。

  2. 解析返回结果
    成功调用后,接口将返回 JSON 格式数据,其中 choices[0].message.content 字段会包含视频的访问链接(或下载地址),示例如下:

    {
      "id": "chatcmpl-xxxxxx",
      "object": "chat.completion",
      "created": 1716888888,
      "model": "sora-2",
      "choices": [
        {
          "message": {
            "role": "assistant",
            "content": "已根据您的需求生成视频,访问链接:https://api.jisuai.top/video/xxxxxx(有效期24小时,可直接下载或嵌入应用)"
          },
          "finish_reason": "stop",
          "index": 0
        }
      ],
      "usage": {
        "prompt_tokens": 58,
        "completion_tokens": 32,
        "total_tokens": 90
      }
    }

    若返回错误(如“密钥无效”“参数格式错误”),可根据 error 字段提示调整:例如密钥无效需重新登录极速API获取;参数错误需检查提示词中的视频参数是否符合“(属性1,属性2,属性3)”格式。

  3. 查看计费明细
    调用完成后,可登录极速API的 Console 控制台(首页导航栏可进入),查看本次调用的计费详情(按量计费,明细透明),同时可监控账号余额,避免因余额不足导致后续调用失败。

注意事项

  1. 合规使用:根据极速API平台规则,该接口仅适用于“测试和体验目的”,需自觉遵守当地法律法规,切勿用于生成侵权、违法内容,平台不承担非法使用的法律责任。
  2. 模型兼容性:若后续需切换为 Claude、Gemini 等其他模型,仅需修改 model 字段(如 model: "claude-3"),无需调整接口路径与 header 格式,实现“一键切换”。
  3. 参数优化:生成视频时,建议在提示词中补充细节描述(如画面风格、镜头角度、背景音),可提升视频生成效果(例如“(横屏,30s,超清)生成科幻风格的城市夜景,镜头从高空缓缓下降,背景音为电子音乐”)。

通过以上三步,即可快速完成 Sora-2 视频模型的对接与调用,无论是个人测试还是小场景应用开发,都能借助极速API的兼容特性,降低技术门槛,高效实现视频生成需求。

About

三步对接sora-2,低至1毛钱一次

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published