(服务端)上传音频作品的链接

正式环境

POST

/karaoke/file/v2/ugc_upload_by_link

用户作品-文件类

三方服务端指定上传音频作品，该接口为异步调用，若服务端受理了请求，将立刻返回成功。K歌会通过file_download_url下载音频文件并进行上传发布，发布成功后结果通过callback_url通知给调用方。
该接口需要进行额外配置才能使用。
注意⚠️，上传域名为：https://f.kg.qq.com

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

可选

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Device-ID

string

可选

设备id，调用KtvSdk.getSdkImei()获取

Body 参数application/json

callback_url

string

可选

服务端调用发布完成的回调地址

content

string

发布描述

可选

cover

string

可选

发布封面图，默认使用歌曲封面

file_download_url

string

可选

文件下载地址（仅链接方式上传需要）

file_id

string

可选

文件id（链接方式上传可能需要）

file_name

string

文件名

可选

file_sha

string

可选

文件hash，sha1方式，小写16进制（用于检测文件正确性）

file_size

integer

可选

文件大小，字节（必填，用于检测文件完整性）

imei

string

IMEI

可选

is_segment

boolean

可选

是否是片段唱（是的话需要传开始和结束时间）

publish_type

integer

可选

立即发布： 0-立即发布 1-保存到草稿箱（暂不发布）

score

integer

得分，整数，大于0

可选

score_rank

integer

可选

得分等级 1～6，分别对应于（C、B、A、S、SS、SSS）

segment_end

integer

片段结束时间

可选

segment_start

integer

片段开始时间

可选

sentence_count

integer

可选

歌词句子数（用户实际录唱的句子数）

share_type

integer

可选

隐私类型：0-公开发布 1-匿名发布

song_id

string

歌曲id（必填）

可选

song_name

string

歌曲名

可选

song_type

enum<integer>

1-音频 2-视频

可选

枚举值:

012

示例

{
  "song_id": "0025ARRr0HqJLg",
  "score": 1234,
  "score_rank": 2,
  "cover": "http://shp.qpic.cn/ttkg/0/506dc4d51122c0af047e47ef83f9fafc598174ad/0?t=1",
  "content": "我用全民K歌唱了一首歌111",
  "file_name": "七里香.mp3",
  "file_size": 2046790
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/file/v2/ugc_upload_by_link?members&reference&Type&_postman_listIndexKey=key&_postman_listAllowsMultipleValues' \
--data-raw '{
    "song_id":"0025ARRr0HqJLg",
    "score":1234,
    "score_rank":2,
    "cover":"http://shp.qpic.cn/ttkg/0/506dc4d51122c0af047e47ef83f9fafc598174ad/0?t=1",
    "content":"我用全民K歌唱了一首歌111",
    "file_name":"七里香.mp3",
    "file_size":2046790
}'

返回响应

🟢200OK

application/json

Body

msg

string

可选

示例

{
  "code": 0,
  "msg": "请求成功",
  "data": "Succ"
}

修改于 2022-12-07 07:32:43

上传音频源文件

通用类