飞影数字人

本文档适用于第三方系统接入飞影数字人的技术文档

通用

所有接口采用 Bearer Token 认证方式，需要在请求的 Header 中填入"Authorization":"Bearer ${token}"。

在调用前请先联系商务获取 token。在调用接口时，如果 token 验证失败，会返回 401 状态，其他业务异常时会返回 200 状态，需要通过响应体中的 code 错误码来识别具体的异常原因。

接口列表

1.1 创建作品

支持使用音频驱动和文本驱动两种方式创作作品。此接口会产生积分消耗。

接口地址

POST /api/v1/hifly/task/create

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

1. 音频驱动

{
"audio_url": "string",
"video_url": "string"
}

2. 文本驱动

{
"voice_id": 1,
"text": "string",
"video_url": "string"
}

出参

{
  "code":0,
  "message":"",
  "job_id":10000,
  "request_id":""
}

1.2 查询作品状态

接口地址

POST /api/v1/hifly/task/inspect

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

{
"job_id": 10000
}

出参

{
  "code":0,
  "message":"",
  "duration":0,
  "status":2,
  "video_Url":"",
  "request_id":""
}

1.3 作品状态通知

在作品处理完成或失败时，触发作品状态回调。调用时使用相同的 Bearer Token 认证。

请求头

method: post

content-type: application/json

请求参数

响应参数

如果响应状态码不为 200，则视为通知失败， 5 分钟内会重试，之后不再重试。

请求示例

入参

{
"title":"",
"job_id": 1,
"status": 3,
"video_Url": "string",
"duration":0,
"message": "string",
"code": 0
}

出参

{}

2.1 创建声音

克隆自己的声音，操作步骤为先创建声音、然后训练声音、再确认声音，完成确认后即可使用这个声音创建作品。此接口创建高保真声音时会产生积分消耗。

接口地址

POST /api/v1/hifly/voice/create

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

{
"type": 20
}

出参

{
  "code":0,
  "message":"",
  "voice_id":1,
  "request_id":""
}

2.2 声音训练

支持中文、英文

接口地址

POST /api/v1/hifly/voice/train

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

{
"voice_id": 1
"audio_url":"url"
}

出参

{
  "code":0,
  "message":"",
  "demo_url":"url",
  "remained_times":1,
  "request_id":""
}

2.3 确认声音

确认使用最后一次的训练音频对声音进行克隆操作，克隆后声音不再支持重新训练。基础版声音在训练后会自动确认。

接口地址

POST /api/v1/hifly/voice/confirm

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

{
"voice_id": 1
"title":"专属声音"
}

出参

{
  "code":0,
  "message":"",
  "request_id":""
}

2.4 调整声音参数

修改高保真声音的参数

接口地址

POST /api/v1/hifly/voice/edit

请求头

content-type: application/json

请求参数

响应参数

请求示例

入参

{
"voice_id": 1,
"rate":"1.0",
"volume":"1.0",
"pitch":"1.0"
}

出参

{
  "code":0,
  "message":"",
  "request_id":""
}

2.5 查询声音列表

查询已完成克隆的声音、以及公版声音

接口地址

GET /api/v1/hifly/voice/list

请求头

content-type: application/json

请求参数

无

响应参数

请求示例

入参

{
}

出参

{
  "code":0,
  "message":"",
  "data":[{
    "voice_id": 213,
    "type": 10,
    "title": "黑土 东北老铁",
    "rate": "",
    "pitch": "",
    "volume": ""
  }],
  "request_id":""
}

3.0 查询账户积分

接口地址

GET /api/v1/hifly/account/credit

请求参数

无

响应参数

请求示例

入参：无

出参

{
  "code":0,
  "message":"",
  "left":10000,
  "request_id":""
}

错误码