NXAI 文档

Appearance

即梦AI-文生视频S2.0Pro ​

POST  v1/video/generations

API文档：https://www.volcengine.com/docs/85621/1538636

请求参数 ​

Authorization ​

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

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

Header 参数 ​

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

Body 参数 ​

Content-Type: application/json

参数名类型必填说明
modelstring必需模型名称。指定使用的图像生成模型 ID（例如 doubao-seedream-4-5 等）。
promptstring必需提示词。描述期望生成的图像内容、风格和构图。
imagestring必需图像输入
metadataobject必需元数据
req_keystring必需请求标识
image_urlsarray[string]必需图片链接数组
aspect_ratiostring必需宽高比
sizestring必需尺寸。支持两种格式： 1. 预设代号：如 2K, 3K。 2. 具体分辨率：如 2048x2048（需符合像素总数限制）。
sequential_image_generationstring必需组图生成模式。控制是否开启多图连续生成功能： • disabled：关闭（默认，单次生成一张）。 • auto：自动判断，根据提示词决定生成一组关联图片。
streamboolean必需流式输出。是否以流式方式返回结果（通常用于实时展示生成进度）。
response_formatstring必需响应格式。指定返回数据的格式，通常为 url（图片链接）或 b64_json（Base64编码）。
watermarkboolean必需水印设置。是否在生成的图片上添加平台水印（如“AI生成”标识）。

请求示例 (JSON) ​

{
    "model": "jimeng_vgfm_t2v_l20",
    "prompt": "一个穿着宇航服的宇航员在月球上行走",
    "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",
    "metadata": {
        "req_key": "jimeng_vgfm_i2v_l20",
        "image_urls": [
            "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"
        ],
        "aspect_ratio": "16:9"
    }
}

返回响应 ​

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": "jimeng_vgfm_t2v_l20",
   "prompt": "一个穿着宇航服的宇航员在月球上行走",
   "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",
   "metadata": {
      "req_key": "jimeng_vgfm_i2v_l20",
      "image_urls": [
         "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"
      ],
      "aspect_ratio": "16:9"
   }
})
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"))