API 开发文档
接口介绍
Nexora AI提供简单易用的RESTful API接口，允许开发者将AI视频生成能力集成到自己的应用中，支持文字生成视频、图片生成视频等能力。
接口根地址： https://api.nexora.ai/v1
请求方式： POST（所有请求均使用POST方法）
所有请求和响应均使用JSON格式，编码方式为UTF-8。
鉴权说明
所有API请求都需要在HTTP请求头中携带API密钥进行鉴权，格式如下：
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx你可以在个人中心-API密钥页面获取你的API密钥，请妥善保管你的密钥，不要泄露给他人。
调用限制
| 套餐 | QPS限制 | 月调用量 |
|---|---|---|
| 免费版 | 不支持API | 不支持API |
| 专业版 | 2 QPS | 1000次/月 |
| 企业版 | 20 QPS | 无限制 |
创建生成任务
创建一个AI视频生成任务，任务创建成功后会返回任务ID，你可以使用任务ID查询生成进度。
POSThttps://api.nexora.ai/v1/video/generate
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 视频描述提示词，最多500字 |
| duration | int | 否 | 视频时长，支持5/10/15/30/60秒，默认5秒 |
| resolution | string | 否 | 分辨率，支持720p/1080p/4k，默认720p |
| fps | int | 否 | 帧率，支持24/30/60，默认24fps |
请求示例
import requests
url = "https://api.nexora.ai/v1/video/generate"
headers = {
"Authorization": "Bearer sk-xxxxxxxxx",
"Content-Type": "application/json"
}
data = {
"prompt": "清晨的森林，阳光穿过树叶，小鹿在溪边喝水，4K高清，电影质感",
"duration": 10,
"resolution": "1080p",
"fps": 30
}
response = requests.post(url, json=data, headers=headers)
print(response.json())查询任务状态
根据任务ID查询视频生成进度和结果。
POSThttps://api.nexora.ai/v1/video/query
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 创建任务时返回的任务ID |
错误码说明
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数错误，请检查参数格式 |
| 401 | 鉴权失败，请检查API密钥是否正确 |
| 403 | 权限不足，请升级套餐 |
| 429 | 请求频率超过限制，请稍后重试 |
| 500 | 服务器内部错误，请联系客服 |
SDK下载
我们提供官方SDK方便你快速集成：