生成工具

短剧项目与六项短剧工具见短剧创作 API，当前创作工具默认未启用。

以下生成工具用于处理已有素材。视频工具统一使用以下异步任务接口，所有请求使用本平台令牌鉴权：

Authorization: Bearer sk-你的令牌
Content-Type: application/json

POST /v1/videos
GET /v1/videos/{task_id}
GET /v1/videos/{task_id}/content

创建请求中的 model 决定使用哪项工具，输入素材使用公网可访问的 HTTP 或 HTTPS URL。可选 lineId 指定可用线路；如果你有自己的服务器，可填写 callbackUrl，让平台在任务完成或失败时通知你的服务器。创建任务、查询结果、接收通知和下载视频的方法见视频任务接口，状态与错误处理见任务与错误。

如提交时发生网络中断或超时，请先核实任务状态，避免重复提交和重复计费。任务完成后请及时保存结果。

视频超分

模型 aik-upscale 接收一个已有视频，支持标准版和专业版，可输出 720p、1080p、2k 或 4k 视频，帧率可选 30 或 60 fps。无需填写提示词。

视频地址也可通过 video_url 传入；时长也可用字符串字段 seconds 传入，例如 "seconds": "12.4"。duration 与 seconds 至少填写一项，同时填写时以 duration 为准。

以下示例将 12.4 秒的视频使用标准版超分至 1080P、30 fps：

curl https://your-domain.example/v1/videos \-H "Authorization: Bearer sk-你的令牌" \-H "Content-Type: application/json" \-d '{  "model": "aik-upscale",  "videoUrls": ["https://example.com/source.mp4"],  "resolution": "1080p",  "duration": 12.4,  "tool_version": "standard",  "fps": 30,  "scene": "aigc",  "enhance_style": "hd",  "bitrate_level": "medium",  "client_request_id": "upscale-001"}'

专业版 4K、60 fps、10 位输出的请求体示例：

{
  "model": "aik-upscale",
  "videoUrls": ["https://example.com/source.mp4"],
  "resolution": "4k",
  "duration": 12.4,
  "tool_version": "professional",
  "fps": 60,
  "bit_depth": 10
}

创建后使用返回的任务 id 查询 GET /v1/videos/{task_id}，完成后通过 GET /v1/videos/{task_id}/content 下载结果。

提交时按传入的视频时长预扣，成功后按实际输出视频时长结算，秒数向上取整。单价由版本、输出分辨率、帧率及当前账号的线路价格决定；使用专业版或更高规格前，请先核对模型中心中的价格。

视频单人换脸

模型 aik-face-swap 接收一个视频和一张目标人脸图片。

{
  "model": "aik-face-swap",
  "videoUrls": ["https://example.com/source.mp4"],
  "imageUrls": ["https://example.com/target-face.png"],
  "client_request_id": "face-swap-001"
}

视频必须为 MP4，最高 1080P、最长 600 秒；人脸图片支持 JPEG、PNG。当前按每帧最大人脸替换，多人视频可能切换对象，建议使用单人出镜视频。

按实际输入视频时长计费，秒数向上取整。

视频口播（口型对齐）

模型 aik-lip-sync 接收一个人物视频和一段驱动音频。

{
  "model": "aik-lip-sync",
  "videoUrls": ["https://example.com/portrait.mp4"],
  "audioUrls": ["https://example.com/voice.m4a"],
  "enable_video_loop": false,
  "client_request_id": "lip-sync-001"
}

视频限 MP4、最长 30 分钟，暂不支持 HDR。仅支持单人出镜，建议人脸正对镜头、无遮挡。音频支持 MP3、AAC、WAV、M4A、FLAC，包含封面图片的音频仍可使用。

enable_video_loop 默认为 false，输出按较短输入截断；设为 true 时，画面通过镜像循环或截断匹配完整音频。按实际输出视频时长结算，秒数向上取整。

人脸打码

模型 aik-face-mask 接收一个待处理视频，自动识别所有人脸并应用马赛克或高斯模糊。

{
  "model": "aik-face-mask",
  "videoUrls": ["https://example.com/source.mp4"],
  "mask_mode": "mosaic",
  "mask_strength": "medium",
  "face_confidence": 0.35,
  "face_box_expand": 0.2,
  "client_request_id": "face-mask-001"
}

视频支持 MP4、FLV、TS、AVI、MOV、WMV、MKV，最长 600 秒、最高 4K、帧率 25–60 fps，推荐使用 1080P。仅接收视频，不支持额外图片或音频。

以上四项参数均可省略。按实际输入视频时长计费，秒数向上取整。

擦除字幕

模型 aik-erase 接收一个待处理视频，自动识别并擦除字幕，再修复擦除区域。

也可以使用 video_url 传入单个视频 URL，但一次任务只能处理一个最长 60 秒的视频。

以下示例仅擦除画面下方区域中的字幕：

curl https://your-domain.example/v1/videos \-H "Authorization: Bearer sk-你的令牌" \-H "Content-Type: application/json" \-d '{  "model": "aik-erase",  "videoUrls": ["https://example.com/source.mp4"],  "mode": "Subtitle",  "output_encode_mode": "Quality",  "erase_ratio_location": [    {      "top_left_x": 0,      "top_left_y": 0.7,      "bottom_right_x": 1,      "bottom_right_y": 1    }  ]}'

视频横转竖

模型 aik-reframe 接收一个横屏视频，默认输出 9:16 竖屏视频；可选一份外部字幕，用于成片烧录。

{
  "model": "aik-reframe",
  "videoUrls": ["https://example.com/landscape.mp4"],
  "subtitleUrls": ["https://example.com/captions.srt"],
  "client_request_id": "reframe-example-001"
}

subtitleUrls 可省略，最多一份 UTF-8 SRT/ASS 字幕，大小不超过 10 MB。不接受图片、驱动音频或其他工具参数。视频支持 MP4、MOV、MKV、AVI、FLV，最长 4 小时、最大 500 MB，画面比例为 16:9、4:3、21:9。

按实际输出视频时长结算，秒数向上取整。