快速开始

一、基本信息

Base URL	`https://newapi.nskeven.uk`
鉴权	`Authorization: Bearer sk-xxx`
请求格式	`application/json`，UTF-8
超时建议	提交 30 秒 / 查询 10 秒 / 下载按成片大小预留

关于 API Key：请使用平台为您分配的令牌，不要自行在控制台新建令牌。令牌带有「分组」属性，不同分组可用的模型不同。视频模型与图片模型通常位于不同分组，用错分组调用会返回 503 model_not_found（见「计费与错误」）。

二、接口一览

用途	Method	路径
创建视频任务	POST	`/v1/video/generations`
查询任务状态	GET	`/v1/video/generations/{task_id}`
下载成片	GET	`/v1/videos/{task_id}/content`
下载成片（带下载头）	GET	`/v1/videos/{task_id}/download`
图片生成	POST	`/v1/images/generations`

三、调用流程

调用 POST /v1/video/generations 创建任务
从响应中取 task_id
每 10～20 秒调用 GET /v1/video/generations/{task_id} 查询
status 为 SUCCESS 时，调用 GET /v1/videos/{task_id}/content 下载成片

四、创建视频任务

POST https://newapi.nskeven.uk/v1/video/generations

请求示例

curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
  -H 'Authorization: Bearer sk-xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "even-sd2.5-A",
    "prompt": "一只猫在雨夜霓虹街道奔跑，电影感，镜头缓慢推进",
    "seconds": "8",
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'

请求参数

参数名	类型	必填	说明
`model`	string	必填	模型名，见模型清单
`prompt`	string	必填	视频内容描述
`seconds`	string	必填	时长（秒）。须传字符串，如 `"5"`、`"8"`；传裸数字会返回 400
`duration`	number	可选	时长（秒，数字）。与 `seconds` 二选一
`resolution`	string	可选	分辨率：`480p` / `720p` / `1080p` / `4k`。各模型支持档见模型清单，建议始终传入
`aspect_ratio`	string	可选	画幅，默认 `16:9`。支持 `16:9` / `9:16` / `1:1` / `4:3` / `3:4`；兼容 `ratio`
`images`	string[]	可选	参考图 URL 数组
`videos`	string[]	可选	参考视频 URL 数组（模型支持时）
`audios`	string[]	可选	参考音频 URL 数组（模型支持时）
`first_frame_url`	string	可选	首帧图 URL
`last_frame_url`	string	可选	尾帧图 URL
`generate_audio`	bool	可选	声音开关，部分模型支持
`metadata`	object	可选	仅特定模型需要，见素材与参数

字段别名（等效）

主字段	兼容写法
`aspect_ratio`	`ratio`
`images`	`image_urls`、`reference_images`、`referenceImages`
`videos`	`reference_videos`、`referenceVideos`
`audios`	`reference_audios`、`referenceAudios`

素材要求：须为公网可直接访问的 HTTP(S) 直链，且响应头 Content-Type 与实际类型一致（图片 image/*、视频 video/mp4、音频 audio/mpeg）。登录态链接无法抓取。

创建返回示例

{
  "id": "task_385412",
  "task_id": "task_385412",
  "object": "video",
  "status": "queued",
  "created_at": 1790224802
}

保存 id（或 task_id，二者相同）用于查询和下载。