通知！Sora2最近调整了一波规则，需要绑定手机验证，GrsAi已经完全解决了该问题，提高了视频成功率！

一、 Grsai Api接入前准备

获取API Key

配置请求头部

HTTP请求的Header中按如下格式添加信息：

{
  "Content-Type": "application/json",
  "Authorization": "Bearer apikey"
}

二、Grsai Sora 2 APi文档详解

1.Sora2视频生成接

接口基本信息

• 接口路径: /v1/video/sora-video
• 请求方式: POST
• 服务地址:
  国内直连: https://grsai.dakka.com.cn
  海外: https://grsaiapi.com

核心功能

• 纯文本生成视频
• 图片+文本组合生成视频
• 提示词@角色id 引用角色视频创作
• remix制作视频续作
• 生成指定比例和时长的视频

remix二创

请求参数详解

{
  "model": "sora-2",
  "prompt": "提示词" #引用角色在这里@id}

• url: 参考图片URL或Base64编码（图片转视频功能）
• aspectRatio: 视频比例，支持"9:16"（竖屏）和"16:9"（横屏），默认9:16
• duration: 视频时长，可选10秒或15秒，默认10秒
• remixTargetId: 续作视频的pid，用于制作视频续集
• size: 视频清晰度，"small"或"large"，默认small

注意事项

• 禁止生成真人视频：该接口不支持生成真人视频内容
• 使用角色：如需使用角色功能，请使用独立的角色上传接口，然后在提示词中用 @角色id格式引用

响应处理方式

• 流式响应（默认）：实时返回生成进度和结果
• Webhook回调：设置 webHook参数，系统将通过POST请求回调您的服务器
• 轮询方式：设置 webHook参数为"-1"，立即返回任务ID，然后使用 /v1/draw/result接口轮询结果

{
  "id": "f44bcf50-f2d0-4c26-a467-26f2014a771b",
  "results": [{
    "url": "https://example.com/example.mp4",
    "removeWatermark": true,
    "pid": "s_xxxxxxxxxxxxxxx"
  }],
  "progress": 100,
  "status": "succeeded"}

使用示例：生成猫咪视频

// 请求示例const response = await fetch('https://grsai.dakka.com.cn/v1/video/sora-video', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "model": "sora-2",
    "prompt": "A cute cartoon cat playing with a ball of yarn on a sunny day",
    "aspectRatio": "16:9",
    "duration": 10,
    "size": "small"
  })});

2.上传角色接口

接口基本信息

• 接口路径: /v1/video/sora-upload-character
• 请求方式: POST

核心功能

重要规则

• 禁止上传真人视频：只能上传卡通、动漫等 非真人角色视频
• 视频片段限制：通过 timestamps参数指定3秒以内的有效片段，格式为"开始秒数,结束秒数"
• 一次上传，多次使用：角色上传成功后，可以在所有后续视频生成中重复使用，提示词@角色id

请求参数

{
  "url": "角色视频URL或Base64",
  "timestamps": "0,3"}

角色引用方法

• 上传成功后，响应中的 character_id即为角色ID
• 在Sora2视频生成接口的 prompt中，使用 @角色id格式引用角色
• 例如：如果 character_id为"cat_character"，则提示词应为："A @cat_character jumping in the garden"

使用流程

示例：上传和使用角色

// 1. 上传角色const uploadResponse = await fetch('https://grsai.dakka.com.cn/v1/video/sora-upload-character', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "url": "https://example.com/cartoon-cat.mp4",
    "timestamps": "0,3"
  })});const characterData = await uploadResponse.json();const characterId = characterData.results[0].character_id; // 例如："cartoon_cat_001"// 2. 使用角色生成视频const videoResponse = await fetch('https://grsai.dakka.com.cn/v1/video/sora-video', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "model": "sora-2",
    "prompt": `A ${characterId} exploring a magical forest with glowing mushrooms`,
    "aspectRatio": "16:9"
  })});

3.从原视频创建角色接口

接口基本信息

• 接口路径: /v1/video/sora-create-character
• 请求方式: POST

核心功能

特色功能

• 支持AI生成的真人类角色：可以从AI生成的视频中创建真人类角色
• 精准提取：通过 timestamps参数指定视频中的特定片段
• 与原视频关联：需要提供原视频的 pid（视频ID）

请求参数

{
  "pid": "s_xxxxxxxxxxxxxxx",
  "timestamps": "0,3"}

使用场景

• 从已生成的视频中（包含Sora2平台的视频，拿到Pid就可以创建）创建角色
• 创建角色系列视频，保持角色的一致性
• 为热门角色制作衍生内容

工作流程

• 先生成原始视频，获取视频的 pid
• 从原始视频中选择3秒内的角色片段
• 调用创建角色接口提取角色
• 获取 character_id后在后续视频中引用

示例：从生成视频中创建角色

// 假设已有一个生成的视频，pid为"s_6964a407c1fc819198458b8abf2b9cdf"// 1. 从视频中创建角色const createCharResponse = await fetch('https://grsai.dakka.com.cn/v1/video/sora-create-character', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "pid": "s_6964a407c1fc819198458b8abf2b9cdf",
    "timestamps": "2,5"  // 提取第2-5秒的角色
  })});const newCharacter = await createCharResponse.json();const newCharacterId = newCharacter.results[0].character_id;// 2. 使用新创建的角色生成新视频const newVideoResponse = await fetch('https://grsai.dakka.com.cn/v1/video/sora-video', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "model": "sora-2",
    "prompt": `The @${newCharacterId} is now attending a grand feast in a castle`,#@角色id    "aspectRatio": "16:9"
  })});

四、结果获取接口

轮询接口

• 接口路径: /v1/draw/result
• 请求方式: POST

const resultResponse = await fetch('https://grsai.dakka.com.cn/v1/draw/result', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer apikey'
  },
  body: JSON.stringify({
    "id": "任务ID"
  })});

五、Sora2计费标准

六、无需手机验证也能用Sora2

操作指南：

总结