20 KiB
20 KiB
Identify-Face（对口型-人脸识别）
OpenAPI Specification
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/klingai/v1/videos/identify-face:
post:
summary: Identify-Face（对口型-人脸识别）
deprecated: false
description: >-
【对口型】人脸识别
用于判断视频是否可用于对口型服务
视频支持.mp4/.mov，文件大小不超过100MB，视频时长不超过60s且不短于2s，仅支持720p和1080p、长宽的边长均位于512px~2160px之间
**价格：0.007 PTC/次**
tags:
- 视频生成/Kling可灵/官方格式
parameters:
- name: Authorization
in: header
description: ''
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
video_url:
type: string
description: 视频URL
required:
- video_url
x-apifox-orders:
- video_url
example:
video_url: >-
https://v1-kling.kechuangai.com/bs2/upload-ylab-stunt/d13e3899-26f7-4246-89f2-ac36d93a45ec-XVyFFzU2buUdk85MAwVZow-outputn6w14.mp4?x-kcdn-pid=112452
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 错误码
message:
type: string
description: 错误信息
request_id:
type: string
description: 请求ID，系统生成，用于跟踪请求、排查问题
data:
type: object
properties:
session_id:
type: string
description: 会话ID，会基于视频初始化任务生成，不会随编辑选区行为而改变，有效期24小时
face_data:
type: array
items:
type: object
properties:
face_id:
type: string
description: 视频中的人脸ID；同一个人脸在视频中间隔超过1s时会视作不同ID
face_image:
type: string
description: 从视频中截图的人脸的示意图
start_time:
type: integer
description: 该人脸可对口型区间起点时间，可作为对口型最佳开始时间
end_time:
type: integer
description: 该人脸可对口型区间终点时间；注：此结果存在毫秒级误差，会长于实际区间终点
x-apifox-orders:
- face_id
- face_image
- start_time
- end_time
required:
- session_id
- face_data
x-apifox-orders:
- session_id
- face_data
required:
- code
- message
- request_id
- data
x-apifox-orders:
- code
- message
- request_id
- data
headers: {}
x-apifox-name: 成功
security: []
x-apifox-folder: 视频生成/Kling可灵/官方格式
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4012774/apis/api-376485194-run
components:
schemas: {}
securitySchemes:
apiKeyAuth:
type: apikey
in: header
name: Authorization
servers:
- url: https://api.302.ai
description: 正式环境
- url: https://api.302ai.cn
description: 国内中转
security: []
Advanced-Lip-Sync（对口型-创建任务）
OpenAPI Specification
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/klingai/v1/videos/advanced-lip-sync:
post:
summary: Advanced-Lip-Sync（对口型-创建任务）
deprecated: false
description: >-
【对口型】创建任务
用于创建对口型任务
音频文件支持传入音频Base64编码或图音频URL（确保可访问）、支持.mp3/.wav/.m4a，文件大小不超过5MB。仅支持使用时长不短于2秒且不长于60秒的音频
**价格：0.07 PTC/次**
tags:
- 视频生成/Kling可灵/官方格式
parameters:
- name: Authorization
in: header
description: ''
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
face_choose:
type: array
items:
type: object
properties:
face_id:
type: string
description: 由人脸识别接口返回
sound_file:
type: string
description: |-
支持传入音频Base64编码或图音频URL（确保可访问）
音频文件支持.mp3/.wav/.m4a，文件大小不超过5MB，格式不匹配或文件过大会返回错误码等信息
仅支持使用时长不短于2秒且不长于60秒的音频
sound_start_time:
type: integer
description: |-
音频裁剪起点时间
以原始音频开始时间为准，开始时间为0分0秒，单位ms
起点之前的音频会被裁剪，裁剪后音频不得短于2秒
sound_end_time:
type: integer
description: |-
音频裁剪终点时间
以原始音频开始时间为准，开始时间为0分0秒，单位ms
终点之后的音频会被裁剪，裁剪后音频不得短于2秒
终点时间不得晚于原始音频总时长
sound_insert_time:
type: integer
description: |-
剪后音频插入时间
以视频开始时间为准，视频开始时间为0分0秒，单位ms
插入音频的时间范围与该人脸可对口型时间区间至少重合2秒时长
插入音频的开始时间不得早于视频开始时间，插入音频的结束时间不得晚于视频结束时间
sound_volume:
type: number
description: |-
音频音量大小；值越大，音量越大
取值范围：[0, 2]
minimum: 0
maximum: 2
original_audio_volume:
type: number
description: |-
原始视频音量大小；值越大，音量越大
取值范围：[0, 2]
原视频无声时，当前参数无效果
minimum: 0
maximum: 2
x-apifox-orders:
- face_id
- sound_file
- sound_start_time
- sound_end_time
- sound_insert_time
- sound_volume
- original_audio_volume
required:
- face_id
- sound_file
- sound_start_time
- sound_end_time
- sound_insert_time
session_id:
type: string
external_task_id:
type: string
description: |-
自定义任务ID
用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询
请注意，单用户下需要保证唯一性
required:
- face_choose
- session_id
x-apifox-orders:
- session_id
- face_choose
- external_task_id
example:
session_id: ''
face_choose:
- face_id: 0
sound_file: >-
https://v1-kling.kechuangai.com/bs2/upload-ylab-stunt/minimax_tts/0522e64c8388bc83f7e72f39576f931b/audiowfegf.mp3?x-kcdn-pid=112452
sound_start_time: 0
sound_end_time: 3000
sound_insert_time: 0
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
description: 错误码；具体定义见错误码
type: integer
message:
description: 错误信息
type: string
request_id:
description: 请求ID，系统生成，用于跟踪请求、排查问题
type: string
data:
type: object
properties:
task_id:
description: 任务ID，系统生成
type: string
task_info:
type: object
properties:
external_task_id:
description: 客户自定义任务ID
type: string
description: 任务创建时的参数信息
x-apifox-orders:
- external_task_id
task_status:
type: string
description: 任务状态
enum:
- submitted
- processing
- succeed
- failed
x-apifox-enum:
- value: submitted
name: ''
description: ''
- value: processing
name: ''
description: ''
- value: succeed
name: ''
description: ''
- value: failed
name: ''
description: ''
created_at:
description: 任务创建时间，Unix时间戳、单位ms
type: integer
updated_at:
description: 任务更新时间，Unix时间戳、单位ms
type: integer
required:
- task_id
- task_info
- task_status
- created_at
- updated_at
x-apifox-orders:
- task_id
- task_info
- task_status
- created_at
- updated_at
required:
- code
- message
- request_id
- data
x-apifox-orders:
- code
- message
- request_id
- data
headers: {}
x-apifox-name: 成功
security: []
x-apifox-folder: 视频生成/Kling可灵/官方格式
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4012774/apis/api-379714705-run
components:
schemas: {}
securitySchemes:
apiKeyAuth:
type: apikey
in: header
name: Authorization
servers:
- url: https://api.302.ai
description: 正式环境
- url: https://api.302ai.cn
description: 国内中转
security: []
Advanced-Lip-Sync（对口型-查询任务）
OpenAPI Specification
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/klingai/v1/videos/advanced-lip-sync/{id}:
get:
summary: Advanced-Lip-Sync（对口型-查询任务）
deprecated: false
description: |-
【对口型】任务查询
用于查询单个任务的视频结果
**价格：0 PTC/次**
tags:
- 视频生成/Kling可灵/官方格式
parameters:
- name: id
in: path
description: 对口型的task_id
required: true
schema:
type: string
- name: Authorization
in: header
description: ''
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
description: 错误码
type: integer
message:
description: 错误信息
type: string
request_id:
description: 请求ID，系统生成，用于跟踪请求、排查问题；全局唯一
type: string
data:
type: object
properties:
task_id:
description: 任务ID，系统生成；全局唯一
type: string
task_status:
type: string
description: 任务状态
enum:
- submitted
- processing
- succeed
- failed
x-apifox-enum:
- value: submitted
name: ''
description: ''
- value: processing
name: ''
description: ''
- value: succeed
name: ''
description: ''
- value: failed
name: ''
description: ''
task_status_msg:
description: 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
type: string
task_info:
type: object
properties:
parent_video:
type: object
properties:
id:
description: 原视频ID；全局唯一
type: string
url:
description: 原视频的URL（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
type: string
duration:
description: 原视频总时长，单位s
type: string
required:
- id
- url
- duration
x-apifox-orders:
- id
- url
- duration
required:
- parent_video
description: 任务创建时的参数信息
x-apifox-orders:
- parent_video
task_result:
type: object
properties:
videos:
type: array
items:
type: object
properties:
id:
description: 视频ID；全局唯一
type: string
url:
description: >-
对口型视频的URL（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
type: string
duration:
description: 对口型视频总时长，单位s
type: string
x-apifox-orders:
- id
- url
- duration
description: 数组是为了保留扩展性，以防未来要支持n
required:
- videos
x-apifox-orders:
- videos
created_at:
description: 任务创建时间，Unix时间戳、单位ms
type: integer
updated_at:
description: 任务更新时间，Unix时间戳、单位ms
type: integer
required:
- task_id
- task_status
- task_status_msg
- task_info
- task_result
- created_at
- updated_at
x-apifox-orders:
- task_id
- task_status
- task_status_msg
- task_info
- task_result
- created_at
- updated_at
required:
- code
- message
- request_id
- data
x-apifox-orders:
- code
- message
- request_id
- data
headers: {}
x-apifox-name: 成功
security: []
x-apifox-folder: 视频生成/Kling可灵/官方格式
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4012774/apis/api-381810693-run
components:
schemas: {}
securitySchemes:
apiKeyAuth:
type: apikey
in: header
name: Authorization
servers:
- url: https://api.302.ai
description: 正式环境
- url: https://api.302ai.cn
description: 国内中转
security: []