Sora 视频接口

Sora 视频生成接口文档。

接口地址

提交任务

POST https://www.moyu.info/v1/videos

查询结果

GET https://www.moyu.info/v1/video/generations/{video_id}

下载视频

GET https://www.moyu.info/v1/videos/{video_id}/content

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

cURL

提交任务响应格式

{
  "id": "video_698333221e6c8190ad6fe0adaf036968",
  "completed_at": 0,
  "created_at": 1770205986,
  "error": {
    "code": "",
    "message": ""
  },
  "expires_at": 0,
  "model": "MODEL_NAME",
  "object": "video",
  "progress": 0,
  "prompt": "",
  "remixed_from_video_id": "",
  "seconds": "8",
  "size": "1280x720",
  "status": "queued"
}

重要：Sora 为异步接口，返回 video_id（即 id 字段）后需要使用该 ID 查询生成结果。

查询结果

使用返回的 video_id 查询视频生成进度和结果。

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "video_698333221e6c8190ad6fe0adaf036968",
    "action": "generate",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1770205986,
    "start_time": 0,
    "finish_time": 0,
    "progress": "20%",
    "data": {
      "id": "video_698333221e6c8190ad6fe0adaf036968",
      "size": "1280x720",
      "error": {
        "code": "",
        "message": ""
      },
      "model": "MODEL_NAME",
      "object": "video",
      "prompt": "A serene mountain landscape at sunrise with golden light",
      "status": "queued",
      "seconds": "8",
      "progress": 0,
      "created_at": 1770205986,
      "expires_at": 0,
      "completed_at": 0,
      "remixed_from_video_id": ""
    }
  }
}

视频生成成功

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "video_698333221e6c8190ad6fe0adaf036968",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1770205986,
    "start_time": 0,
    "finish_time": 1770206200,
    "progress": "100%",
    "data": {
      "id": "video_698333221e6c8190ad6fe0adaf036968",
      "size": "1280x720",
      "error": {
        "code": "",
        "message": ""
      },
      "model": "MODEL_NAME",
      "object": "video",
      "prompt": "A serene mountain landscape at sunrise with golden light",
      "status": "completed",
      "seconds": "8",
      "progress": 100,
      "created_at": 1770205986,
      "expires_at": 0,
      "completed_at": 1770206200,
      "remixed_from_video_id": ""
    }
  }
}

下载视频

下载请求示例

cURL

其他语言

停止任务

在任务执行过程中，可以取消正在进行的任务。

停止请求示例

cURL

其他语言

停止任务响应格式

{
  "id": "video_698333221e6c8190ad6fe0adaf036968",
  "object": "video",
  "model": "MODEL_NAME",
  "status": "cancelled",
  "progress": 100,
  "created_at": 1770267350,
  "completed_at": 1770267360,
  "error": {
    "message": "Task cancelled by user",
    "code": "task_cancelled"
  }
}

注意：

只能停止状态为 queued 或 in_progress 的未完成任务。已完成（completed）或已失败（failed）的任务会被接口直接拒绝（返回 400），无法取消。

上方响应中的 "status": "cancelled" 是取消操作这一次响应里的一次性状态。任务在库中实际落为 FAILURE（失败原因记为 Cancelled by user），因此再次查询该任务时状态为 failed，不会再返回 cancelled。

请求参数

提交任务参数

参数	类型	必填	说明
model	string	是	模型名称
prompt	string	是	视频描述提示词，详细描述想要生成的视频内容
width	integer	是	视频宽度，支持 1280 或 720
height	integer	是	视频高度，支持 720 或 1280
metadata	object	是	扩展参数对象
metadata.seconds	string	是	视频时长，支持 "4", "8", "12"（秒）
image_url	string	图生视频时需要	输入图片的URL地址
fps	integer	否	视频帧率
seed	integer	否	随机种子，用于可重复生成
n	integer	否	生成视频数量
user	string	否	用户标识符

分辨率说明：

横屏视频：1280x720

竖屏视频：720x1280

其他分辨率（如 1920x1080、1280x1280）不支持

图生视频说明：

图生视频需要提供 image_url 参数，指向输入图片的URL地址

输入图片分辨率应与生成视频的 width 和 height 保持一致

prompt 参数用于描述视频中的运动和变化效果

时长说明：

metadata.seconds 必须为字符串类型

支持的值："4"（4秒）、"8"（8秒）、"12"（12秒）

使用其他值会导致任务失败

提示词建议：

使用详细、具体的描述

包含场景、光线、动作、情绪等元素

建议使用英文以获得更好的效果

长度适中，避免过于简短或冗长

响应字段说明

提交任务响应字段

字段	类型	说明
id	string	视频唯一标识符（video_id），用于查询和下载
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	任务状态：queued(排队中)、processing(处理中)、completed(完成)、failed(失败)
prompt	string	视频描述提示词
seconds	string	视频时长（秒）
size	string	视频分辨率，格式为 "宽x高"
progress	integer	进度百分比
created_at	integer	创建时间戳
completed_at	integer	完成时间戳
expires_at	integer	过期时间戳
error	object	错误信息对象

查询结果响应字段

字段	类型	说明
code	string	响应码，"success" 表示查询成功
message	string	响应消息
data.task_id	string	任务ID（即 video_id）
data.action	string	操作类型，如 "generate"
data.status	string	任务状态：QUEUED(排队中)、PROCESSING(处理中)、SUCCESS(成功)、FAILURE(失败)
data.progress	string	进度百分比，如 "20%", "100%"
data.submit_time	integer	提交时间戳
data.start_time	integer	开始时间戳
data.finish_time	integer	完成时间戳
data.fail_reason	string	失败原因
data.data.id	string	视频ID
data.data.model	string	使用的模型
data.data.status	string	详细状态：queued(队列中)、processing(处理中)、completed(完成)
data.data.prompt	string	视频描述提示词
data.data.seconds	string	视频时长
data.data.size	string	视频分辨率

接口地址#

提交任务#

查询结果#

下载视频#

请求示例#

文生视频 (Text-to-Video)#

cURL#

其他语言#

图生视频 (Image-to-Video)#

cURL#

提交任务响应格式#

查询结果#

查询请求示例#

cURL#

其他语言#

查询响应格式#

任务进行中#

视频生成成功#

下载视频#

下载请求示例#

cURL#

其他语言#

停止任务#

停止请求示例#

cURL#

其他语言#

停止任务响应格式#

请求参数#

提交任务参数#

响应字段说明#

提交任务响应字段#

查询结果响应字段#

接口地址

提交任务

查询结果

下载视频

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

cURL

提交任务响应格式

查询结果

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

视频生成成功

下载视频

下载请求示例

cURL

其他语言

停止任务

停止请求示例

cURL

其他语言

停止任务响应格式

请求参数

提交任务参数

响应字段说明

提交任务响应字段

查询结果响应字段