全民K歌IOT开放平台
  1. 用户作品-文件类
全民K歌IOT开放平台
  • 厂商合作流程
  • 快速接入
  • SDK bug提单规范
  • 如何在线调试接口
  • 常见问题
  • 业务错误码说明
  • 开放平台接入指南
    • 登录鉴权方式介绍V2(推荐)
    • 如何申请接入
    • CDK权限申请流程
    • 获取应用级token
      POST
    • 获取登录二维码
      POST
    • 查询二维码的状态
      POST
    • 获取用户级token
      POST
    • 刷新用户级token
      POST
  • 基础类
    • tagId对照表
    • 歌曲详情
      POST
    • 查询mv的播放地址
      POST
    • 搜索
      POST
    • 搜索联想
      POST
    • 查询歌手歌曲
      POST
    • 获取歌曲歌词文件
      POST
    • 搜索某歌手的歌曲
      POST
    • Q音歌曲mid映射K歌
      POST
    • 短剧播放链接
      POST
    • 查询应用限免配置
      POST
  • 运营类
    • 排行榜id说明
    • 获取城市id列表
    • 获取专题分类列表
    • 获取云端配置
    • 热门ugc
    • 热搜词
    • 排行榜
    • 获取专题下歌曲信息
    • 获取车联渠道映射
    • 热门推荐
    • (新)排行榜
    • 综合歌单列表查询
    • 设置缓存设备
    • TV版分类歌单列表
    • 获取TV频道页tab配置
    • 获取用户协议
    • 获取广告配置
    • 拉取短剧合集的列表
  • 用户类
    • 用户信息查询
    • 删除用户UGC作品
    • 获取推荐/翻唱作品
    • 获取同城作品
    • 用户作品列表
    • 获取好友作品
    • UGC作品详情
    • 更改作品访问权限
    • 用户个推歌单
  • 支付类
    • 支付接入流程
    • 订单发货使用简述
    • 开通设备会员限免简述
    • 通用sign计算规则
    • 通用返回结构
    • 【CDK】CDK兑换
    • 【CDK】生成CDK
    • 【CDK】CDK召回
    • 【CDK】CDK状态查询
    • 【三方支付】订单发货
    • 【三方支付】手机号发货
    • 【三方支付】订单状态查询
    • 【米大师支付】获取会员商品列表
    • 【米大师支付】未登录-查询会员商品列表
    • 【米大师支付】支付下单
    • 【米大师支付】支付成功通知
    • 【米大师支付】查询用户支付成功订单记录
    • 查询设备以及用户是否有赠送资格
    • 查询设备限免剩余时长
    • 退款设备会员
    • 设备会员迁移
    • 查询会员赠送时长
    • 同步支付订单接口
    • 【三方支付】存量会员迁移领取查询
    • 【三方支付】存量会员迁移接口
    • 授权设备体验会员
    • 查询用户会员信息
    • 【三方支付】超会发货
  • 用户作品-文件类
    • callback_url说明
    • 上传音频源文件
      POST
    • (服务端)上传音频作品的链接
      POST
  • 通用类
    • 【厂商定制】匹配搜索
    • 【腾讯视频专用】获取SDK请求使用的token
    • 获取kg的短链接
  1. 用户作品-文件类

上传音频源文件

正式环境
https://api.kg.qq.com
正式环境
https://api.kg.qq.com
POST
/karaoke/file/v2/ugc_upload_by_file
用户作品-文件类
客户端上传音频文件作品。content-type为multipart/form-data。
注意⚠️,上传域名为:https://f.kg.qq.com

请求参数

Header 参数
X-Open-Access-Token
string 
必需
access token
默认值:
{{X-Open-Access-Token}}
X-Open-ID
string 
openid
可选
默认值:
{{X-Open-ID}}
X-Open-App-ID
string 
业务appid
必需
默认值:
{{X-Open-App-ID}}
Device-ID
string 
可选
设备id,调用KtvSdk.getSdkImei()获取
Body 参数multipart/form-data
data
string 
必需
ugc信息,同《(服务端)上传音频作品的链接》接口的请求参数,需要打包json文本
示例值:
{ "song_id":"0025ARRr0HqJLg", "song_name":"七里香", "song_type":1, "publish_type":0, "share_type":0, "score":1234, "score_rank":2, "content":"我用全民k歌唱了一首歌", "cover":"http://shp.qpic.cn/ttkg/0/506dc4d51122c0af047e47ef83f9fafc598174ad/0?t=1", "file_name":"七里香.mp3", "file_sha":"", "file_size":32361, "is_segment":false, "segment_start":0, "segment_end":0, "sentence_count":60, "imei":"" }
ugc_file
file 
源文件
必需

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kg.qq.com/karaoke/file/v2/ugc_upload_by_file' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--form 'data="{
    \"song_id\":\"0025ARRr0HqJLg\",
    \"song_name\":\"七里香\",
    \"song_type\":1,
    \"publish_type\":0,
    \"share_type\":0,
    \"score\":1234,
    \"score_rank\":2,
    \"content\":\"我用全民k歌唱了一首歌\",
    \"cover\":\"http://shp.qpic.cn/ttkg/0/506dc4d51122c0af047e47ef83f9fafc598174ad/0?t=1\",
    \"file_name\":\"七里香.mp3\",
    \"file_sha\":\"\",
    \"file_size\":32361,
    \"is_segment\":false,
    \"segment_start\":0,
    \"segment_end\":0,
    \"sentence_count\":60,
    \"imei\":\"\"
}"' \
--form 'ugc_file=@""'

返回响应

🟢200OK
application/json
Body
file_id
string 
可选
paly_url
string 
音视频播放链接
可选
share_id
string 
可选
ugc_id
string 
可选
vid
string 
视频,音频
可选
示例
{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "file_id": "1021_s_0b53jd5aaiqaz4ahw6mcgzq36sgdaa6aa3ka",
    "paly_url": "",
    "ugc_id": "67959b8d262a348d302176d9b1c9cfc568b8f09dd8b3e8a7 ",
    "share_id": "gUcsfYgVrlD0xg3x"
  }
}
上一页
callback_url说明
下一页
(服务端)上传音频作品的链接
Built with