代码DEMO

团子提供必要的代码DEMO，包含数种语言的实现，方便开发者快速上手使用。

如何与团子通信

以下为如何与团子通信的代码DEMO。

该接口将返回你发送的请求体内容，来验证你的请求体、请求头和token是否正确。

该片段为最基本的和团子通信的写法，如需要其他的API请求，只需要替换请求地址、请求体和请求头，举一反三即可。

JavaScript
// 需要的依赖：axios（网络请求库）, md5（MD5摘要算法实现库）
const axios = require('axios')
const md5 = require('md5')

// 替换为自己的appKey、secret
const appKey = '***' 
const secret = '***'

function buildToken(appKey, secret) {
	const timestamp = Date.now()
	return appKey + "$$" + timestamp + "$$" + md5(secret + timestamp)
}

const request = axios.post(
	'https://api.tuanziai.com/echo',
	{"test": "my-test-string"},
	{
		headers: {
			"token": buildToken(appKey, secret), 
            "Content-Type": "application/json"
		}
	}
)

request.then(response => {
	// 输出为：
	//Response: { code: 0, message: 'success', data: 'my-test-string' }
	console.log('Response:', response.data)
})

创建通道并上传歌曲

这里给出创建上传通道、上传歌曲文件到阿里云OSS、并开始处理歌曲的代码DEMO，以伴奏人声提取功能为例。

额外需要注意的是，这里只做了最精简的封装，并没有考虑网络请求的重试、异常处理、以及一些边界情况，请开发者根据自己的实际情况进行完善。

JavaScript
// 需要的依赖：axios（网络请求库）, md5（MD5摘要算法实现库），fs（Node环境下的文件系统模块，如果浏览器环境需要file对象代替）
const axios = require('axios')
const md5 = require('md5')
const fs = require('fs')

const appKey = '**'
const secret = '**'

function buildToken(appKey, secret) {
	const timestamp = Date.now()
	return appKey + '$$' + timestamp + '$$' + md5(secret + timestamp)
}

// 简单的封装一个请求函数，方便后续调用
function postToDango(url, body) {
	return axios.post(url, body, {
		headers: {
			'token': buildToken(appKey, secret),
			'Content-Type': 'application/json'
		}
	})
}

async function uploadToDango(filePath) {
	// 第一步：创建上传通道
	const {url, form, channel} = (await postToDango('https://api.tuanziai.com/vocal-remover/upload/channel', {
		"uploadVersion": 2,
		"style": 29,
		"filename": "test.mp3",
		"config": {
			"separateBackingVocals": false
		}
	})).data.data

	// 第二步：使用返回的url和form字段上传文件到OSS
	// 当前代码为Node环境，如果是浏览器环境，可以使用file对象和FormData来上传。
	await axios.postForm(
		url, //无需关心上传到哪里，直接使用团子返回的url字段 
        {
            ...form, // 无需关心团子提供的form都有什么键值，直接“一股脑”将form字段展开作为请求体的一部分
            file: fs.createReadStream(filePath) //在form的最后添加一个file字段，值为要上传的文件
	    }
	)

	// 第三步：通知团子上传完成，并获取musicId
	const musicId = (await postToDango(`https://api.tuanziai.com/vocal-remover/upload/${channel}/result`)).data.data

	return musicId
}

uploadToDango('d:\\test\\real.wav').then(musicId => {
	// 输出为：
	// 上传成功，音乐ID: f81be254ec5242d29be254ec52c2d2e2
	// 之后就可以使用这个音乐ID去请求处理结果了，具体接口文档请参考开放平台文档
	console.log('上传成功，音乐ID:', musicId)
})