NXAI 文档

Appearance

可灵AI-文生视频 ​

POST  v1/video/generations

使用 Kling 模型从文本描述生成视频。

支持的模型：kling-v1, kling-v1-5 等

请求参数 ​

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": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
    "size": "1920x1080",
    "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
    "duration": 5,
    "metadata": {
        "seed": 20231234,
        "negative_prompt": "模糊",
        "image_tail": "https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png"
    }
}

返回响应 ​

200 成功

Content-Type: application/json

响应参数 ​

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

响应示例 ​

{
    "created": 0,
    "data": [
        {
            "url": "string"
        }
    ]
}

示例代码 ​

python
import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
   "model": "kling-v1",
   "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
   "size": "1920x1080",
   "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
   "duration": 5,
   "metadata": {
      "seed": 20231234,
      "negative_prompt": "模糊",
      "image_tail": "https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png"
   }
})
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"))