555 lines
20 KiB
Markdown
555 lines
20 KiB
Markdown
# Identify-Face（对口型-人脸识别）
|
||
|
||
## OpenAPI Specification
|
||
|
||
```yaml
|
||
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
|
||
|
||
```yaml
|
||
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
|
||
|
||
```yaml
|
||
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: []
|
||
|
||
``` |