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

Sora2 A文档看不懂？到底怎么调用啊？可以上传真人创建角色吗？3个不同的api都有什么用？怎么收费？

本文将详细介绍GrsAI APi源头供应商，提供的三个核心视频生成接口的使用方法，帮助开发者快速接入强大的0.08/条的Sora 2视频生成能力。文末也提供了普通用户使用教程！往下看吧。

我们将重点介绍Sora2视频接口、上传角色接口和从原视频创建角色接口具体使用方法和限制。

一、Grsai api接入前准备

GrsAI（Grsai.com com 域名需要魔法才可访问，没有改成ai)是一个专注于聚合海外主流AI大模型的API服务平台，所有模型均为源头提供非中间商赚差价。所以能以低于官方渠道和市场的价格提供模型调用服务，例如Sora2——0.08/条，Nano Banana Pro——0.09/张，Nano banana——0.22/张，Gpt image 1.5——0.02/张，Veo3.0/Veo3.1——0.4/条，Gemini2.5，Gemini3.....同时支持高并发请求，适合批量任务，大流量产品。并且失败不扣费积分秒返还，还提供国内直连和海外两种接入节点，方便全球用户低延迟访问。

获取API Key

API Key是您调用所有GrsAI接口的身份凭证，需要在每次请求的头部（Header）中携带，请妥当保存不要外泄。

（1）进入Grsai控制台：https://grsai.com/zh/dashboard/api-keys（com需要魔法，没有改成ai）

（2）生成API Key：点击“创建”按钮，为密钥命名后还可以限制额度，生成后复制使用。

配置请求头部

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

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

请将 <API Key> 替换为您在控制台实际获取的密钥字符串。

二、Grsai Sora 2 APi文档详解

1.Sora2视频生成接

接口基本信息

• 接口路径: /v1/video/sora-video

• 请求方式: POST

• 服务地址:

  国内直连: https://grsai.dakka.com.cn

  海外: https://grsaiapi.com

核心功能

Sora2视频接口可以根据文本提示词（prompt）或参考图片生成高质量视频，0可以通过此接口：

• 纯文本生成视频

• 图片+文本组合生成视频

• 提示词@角色id 引用角色视频创作

• remix制作视频续作

• 生成指定比例和时长的视频

remix二创

Remix（重混/重制）允许你基于一段已有 Sora 生成的视频（需要Pid），输入新提示词（prompt）进行修改或延续，而不从零重新生成整个视频。

核心参数是 remixTargetId ，参考results的pid值: s_xxxxxxxxx

添加 remixTargetId 参数，填入原始视频的 ID

请求参数详解

必填参数：

{
  "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.上传角色视频，获取character_id

2.在生成视频时，在提示词中引用该角色

示例：上传和使用角色

// 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生成的真人类角色：可以从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

当使用Webhook参数为"-1"时，可以使用此接口轮询任务状态：

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 生成视频Api——0.08/条，Sora2 角色上传Api——0.01/条，Sora2从原视频上传角色Api——0.01/条。

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

你是不是也遇到了Sora2需要手机验证？到处找人结果都要氪金才能解决？本来Sora2一天生成的次数就有限制，这样太不划算了，不如直接用Grsai提供的批量生图工具，一条视频0.08还没有生成次数限制！

Sora2 批量生图工具：https://image.grsai.com/ （com需要魔法，没有改成ai）

操作指南：

1.在GrsAi控制台：https://grsai.com/zh/dashboard/api-keys（com需要魔法，没有改成ai） 获取APiKey，有基础额度5000可免费用

2.在批量生成工具：https://image.grsai.com/ （com需要魔法，没有改成ai） 右上角绑定APikey

3.选择Sora2模型即可使用

Grsai 批量生成工具可使用Nano banana pro ，Nano banana，Sora2，Veo等模型，不限制生成数量，可批量打包下载，适合批量抽卡用户，生成失败不扣费！普通用户直接用APi低价使用模型。

注意：生成的内容只会保存2小时，需要尽快下载。

总结

在对接Grsai的Sora-2 APi接口时需要注意！不支持真人生成视频或创建角色，若需使用真人形象，需要先“视频生成接口”用提示词生成人物视频，在用“从原视频创建角色接口”获取character_id，最后在“视频生成接口”的提示词中 @角色ID 引用角色，角色创建成功后无需重复上传。生成失败秒退款，可放心使用。

通过合理组合使用这三个接口，您可以构建出复杂的视频生成应用，保持角色一致性，创作出系列化的视频内容。