NXAI 文档

Appearance

可灵AI-图生视频 ​

POST  v1/video/generations

使用 Kling 模型从图片生成视频。

支持通过 image 参数传入图片 URL 或 Base64 编码的图片数据

请求参数 ​

Authorization ​

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

Header 参数 ​

参数类型必填说明示例
Content-Typestring可选请求体的数据格式类型application/json
Acceptstring可选客户端期望接收的响应数据格式application/json

Body 参数 ​

Content-Type: application/json

参数名类型必填说明
modelstring必需模型 ID。指定使用的生成模型版本。
promptstring必需文本描述。期望生成内容的详细文字描述。
sizestring必需图片尺寸。指定生成图像的分辨率大小。
imagestring必需图像输入。用于编辑、变体生成或作为参考的基础图像数据。
durationinteger必需时长。生成视频的持续时间（通常以秒为单位）。
aspect_ratiostring必需宽高比。画面比例（例如 "16:9", "1:1"）。
response_formatstring必需响应格式。指定返回数据的格式（如 "url" 或 "b64_json"）。
streamboolean必需流式输出。设为 true 时，结果将通过服务器发送事件（SSE）流式传输。
watermarkboolean必需水印设置。是否在生成的内容上添加可见的水印标识。
sequential_image_generationstring必需连续图像生成。控制是否基于前一张图进行连续性的画面生成。
metadataobject必需元数据。附加的结构化信息，用于存储额外的配置或追踪数据。
req_keystring必需请求标识。用于追踪本次请求的唯一键值。
image_urlsarray[string]必需图片链接数组。提供一组图片 URL，常用于批量处理或作为参考图输入。
seedinteger必需随机种子。设定固定的种子值可以使生成结果具有可复现性。
negative_promptstring必需反向提示词。描述不希望出现在生成结果中的元素或特征。
image_tailstring必需尾部图像。可能用于指定序列生成的最后一帧或特定的结尾图像约束。

请求示例 (JSON) ​

{
    "model": "kling-v1",
    "prompt": "人物转身走开",
    "image": "https://example.com/image.jpg",
    "duration": 5,
    "width": 1280,
    "height": 720
}

返回响应 ​

200 成功

Content-Type: application/json

响应参数 ​

字段名类型必填说明
createdinteger必需创建时间戳。该图像生成任务完成时的 Unix 时间戳。
dataarray [object]必需数据数组。包含实际生成结果的数组（通常包含一个或多个图片对象）。
├─ urlstring必需图片链接。生成的图像文件的访问地址（通常在 data 数组的对象内部）。

响应示例 ​

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}

示例代码 ​

python
import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
   "model": "kling-v1",
   "prompt": "人物转身走开",
   "image": "https://example.com/image.jpg",
   "duration": 5,
   "width": 1280,
   "height": 720
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/video/generations", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))