Nexora AI 视频生成 API

接口介绍

欢迎使用Nexora AI视频生成API，你可以通过简单的HTTP接口调用，在你的应用中集成AI视频生成能力，支持文字生成视频、图片生成视频等功能。

接口域名：https://api.nexora.ai/v1

请求方式： 所有接口均使用POST方式，请求体为JSON格式

鉴权方式

所有API请求都需要在请求头中携带你的API密钥进行鉴权：

Authorization: Bearer sk_nexora_xxxxxxxxxxxxxxxxxxxxxxx

你可以在个人中心-API密钥页面获取你的API密钥。

生成视频接口

提交视频生成任务，接口会立即返回任务ID，你可以通过查询接口获取生成结果。

POST /video/generate

请求参数

参数名 类型 必填 说明
prompt string 是 视频描述提示词，越详细效果越好
duration int 否 视频时长，支持5/10/15秒，默认5秒
resolution string 否 分辨率：720p/1080p/4k，默认1080p
aspect_ratio string 否 画面比例：16:9/9:16/1:1，默认16:9

请求示例

// curl 示例
curl -X POST https://api.nexora.ai/v1/video/generate \
  -H "Authorization: Bearer sk_nexora_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只橘猫在夕阳下的海边奔跑，慢镜头，电影级画面",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "task_id": "task_20260924_abc123",
    "estimated_time": 10
  }
}

查询任务接口

通过任务ID查询视频生成进度和结果。

POST /video/query

请求参数

参数名 类型 必填 说明
task_id string 是 生成接口返回的任务ID

返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "task_id": "task_20260924_abc123",
    "status": "success", // pending/processing/success/failed
    "progress": 100,
    "video_url": "https://cdn.nexora.ai/videos/xxx.mp4",
    "cover_url": "https://cdn.nexora.ai/covers/xxx.jpg"
  }
}

错误码说明

错误码 说明 解决方案
401 API密钥错误或无效 检查你的API密钥是否正确
402 账户余额/额度不足 前往购买页充值或升级套餐
400 参数错误 检查请求参数是否符合要求
429 请求频率超限 降低请求频率，联系客服提升QPS
500 服务器内部错误 稍后重试，若持续出现请联系客服

调用限制

  • 专业版用户API QPS限制为2次/秒，企业版用户QPS限制为10次/秒，更高QPS请联系客服定制
  • 生成的视频链接有效期为7天，请及时下载保存到你的本地存储
  • 禁止生成违法违规、色情暴力、侵权等内容，违反者将封禁账号