跳转到主要内容

​
角色动画集成

为了增强角色动画功能，您可以使用 character_url 和 character_timestamps 参数来创建角色动画：

Sora2 - Characters

了解如何创建角色动画并获取 character_id_list 用于集成

​
查询任务状态

提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：

Get Task Details

了解如何查询任务状态并获取生成结果
生产环境中，建议使用回调通知接收生成完成的自动通知，而非轮询状态端点。

​
相关资源

Market Overview

浏览所有可用模型

Common API

查看账户积分与使用情况

​
API 参考

​
请求

POST https://api.ruxa.ai/api/v1/tasks/create

​
请求头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
请求体参数

参数类型必填描述
modelstring是模型名称：sora-2 或 sora-2-hd
promptstring是视频描述提示词
secondsstring否视频时长：10、15、25（仅 pro 支持）
input_referencefile否输入参考图像
sizestring否视频尺寸（见下方说明）
watermarkboolean否是否需要水印，默认无水印
privateboolean否是否隐藏视频，true 时视频不会发布且无法 remix，默认 false
character_urlstring否创建角色需要的视频链接（视频中不能出现真人）
character_timestampsstring否视频角色出现的秒数范围，格式 {start},{end}，范围 1~3 秒
metadatastring否元数据
character_from_taskstring否已完成的任务 ID，可根据已生成的任务创建角色
character_createboolean否创建视频完成后，自动根据生成的视频创建角色
stylestring否风格：winter（冬天）、comic（漫画）、news（新闻）

​
Size 尺寸说明

值描述备注
1024x1792高清竖屏仅 sora-2-hd 可用
1792x1024高清横屏仅 sora-2-hd 可用
720x1280标清竖屏
1280x720标清横屏
宽 > 高 为横屏，宽 < 高 为竖屏

​
请求示例

{
  "model": "sora-2",
  "prompt": "牛马起飞",
  "seconds": "10",
  "size": "1280x720",
  "watermark": false,
  "private": false
}

​
带角色创建的请求示例

{
  "model": "sora-2",
  "prompt": "角色在草地上奔跑",
  "seconds": "10",
  "size": "1280x720",
  "character_url": "https://example.com/character-video.mp4",
  "character_timestamps": "0,3",
  "character_create": true
}

​
带风格的请求示例

{
  "model": "sora-2",
  "prompt": "城市街道场景",
  "seconds": "10",
  "size": "1280x720",
  "style": "comic"
}

​
响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_sora-2_1765184045509"
  }
}

​
响应状态码

状态码描述
200成功
401未授权 - 身份验证凭据缺失或无效
402积分不足
404未找到
422验证错误 - 请求参数未通过校验
429速率限制
500服务器错误
501生成失败