能力集成

1333 字约 4 分钟

2024-12-26

Api快速集成

【JSON-To-Video】内容编排

【JSON-To-Video】动效配置

控制方式

提示

趣浪吧视频制作，核心能力为云端渲染制作视频。

通过Api访问，可以轻松控制自有账号，批量进行短视频的制作。

前往【趣浪吧】公众号，注册访问账号
获取【API-Token】
调用视频制作API，等待视频制作完成
调用视频状态API，返回视频地址URL

API请求访问

提示

能够根据用户提供的标题和解说文案轻松制作出短视频（.mp4 格式），帮助用户快速生成具有吸引力的视频内容。

视频制作API

重要

请求URL:

https://enterprise.qulang8.cn/api/shortVideo/makeVideoByToken

请求方式：POST

数据交互：application/json

返回类型：JSON

查看请求参数说明

参数	类型	说明
token	String	API-Token 请前往公众号【趣浪吧】获取
replace	Boolean	替换方式，默认false false=保留原参数、覆盖替换 true=全量替换、不保留原参数
content	String	解说文案，字数不要超过250字
videoTemplateId	String	1：新闻资讯 2：漫画解说
worker	Boolean	是否启用worker模式，默认false false=趣浪吧帮助限流调用，每次仅支持一路制作 true=趣浪吧不限流，支持多路并发制作，请求成功将返回workerId
...	Any	视频创作WEB-IDE，浏览效果案例配置参数说明

查看响应参数说明

参数	类型	说明
err	Number	错误码
	0	请求成功，已安排制作
	26002	无效的API-Token
	26003	积分余额或调用余额不足
	26004	视频制作中
	26005	title长度不得大于30 或 content长度不得大于200
	26007	无效的视频制作模板
msg	String	错误信息
data	Object	JSON数据
data.workerId	String	视频制作进程Id

视频状态查询API

重要

请求URL:

https://enterprise.qulang8.cn/api/shortVideo/getDetailByToken

请求方式：POST

数据交互：application/json

返回类型：JSON

查看请求参数说明

参数	必填	说明
token	*	API-Token 请前往公众号【趣浪吧】获取
workerId		视频制作进程Id

查看响应参数说明

参数	类型	说明
err	Number	错误码
	0	请求成功
	26002	无效的API-Token
	26008	无效的workerId
data	Object
data.status	Number	当前视频制作状态
data.videoUrl	String	已制作完成短视频的下载地址（仅当status=99时，才是正确的访问地址）

多人语音合成API

重要

请求URL:

https://enterprise.qulang8.cn/api/ai/makeTTSByToken

请求方式：POST

数据交互：application/json

返回类型：JSON

查看请求参数说明

参数	类型	说明
token	String	API-Token 请前往公众号【趣浪吧】获取
wordList	Array	多人语音内容数组
wordList[text]	String	语音配置
wordList[tts][voice]	String	音色
qlv-8727521184e54282868bc1c02fb50c8a	史诗神话解说
qlv-8727521184e54282868bc1c02fb50c8a	互动清爽
longcheng_v2	龙橙
longhua_v2	龙华
longshu_v2	龙书
loongbella_v2	龙贝
longwan_v2	龙婉
longxiaochun_v2	龙淳
longxiaoxia_v2	龙夏

案例

{
    "token":"Your_API_Token",
    "wordList": [
    {
      "text": "银甲天使手持圣戟，背后羽翼闪耀着圣洁光辉。",
      "tts": {
        "voice": "qlv-8727521184e54282868bc1c02fb50c8a"
      }
    },
    {
      "text": "黑袍恶魔挥舞魔镰，周身环绕着阴森魔气。",
      "tts": {
        "voice": "qlv-8727521184e54282868bc1c02fb50c8a"
      }
    }
  ]
}

查看响应参数说明

参数	类型	说明
err	Number	错误码
	0	请求成功，已安排制作
	28001	错误的请求内容
	28002	积分余额或调用余额不足
	28003	AI生成中
	28004	无效的API-Token
	28006	错误的解说稿内容
msg	String	错误信息
data	Object	JSON数据
data.execId	String	任务制作进程Id

案例

{
    "err": 0,
    "data": {
        "execId": "Your_Job_ExecId"
    }
}

语音合成人物状态查询API

重要

请求URL:

https://enterprise.qulang8.cn/api/ai/getTTSByToken

请求方式：POST

数据交互：application/json

返回类型：JSON

查看请求参数说明

参数	必填	说明
token	*	API-Token 请前往公众号【趣浪吧】获取
execId		语音合成任务Id

案例

{
    "token":"Your_API_Token",
    "execId":"Your_Job_ExecId"
}

查看响应参数说明

参数	类型	说明
err	Number	错误码
	0	请求成功
	28003	AI生成中
	28004	无效的API-Token或任务id
data	Object
data.wordList	Array[Object]
data.wordList[text]	String	文案内容
data.wordList[start]	String	开始时间（秒）
data.wordList[end]	String	结束时间（秒）
data.audioUrl	String	已制作完成音频地址

案例

{
    "err": 0,
    "data": {
        "wordList": [
            {
                "text": "云雾翻涌的天际，巍峨的天堂之门光芒流转，神圣与邪恶在此激烈交锋。",
                "start": 0,
                "end": "10.57"
            },
            {
                "text": "银甲天使手持圣戟，背后羽翼闪耀着圣洁光辉。",
                "start": "10.57",
                "end": "17.14"
            },
            {
                "text": "黑袍恶魔挥舞魔镰，周身环绕着阴森魔气。",
                "start": "17.14",
                "end": "23.31"
            },
            {
                "text": "双方剑拔弩张，一场关乎天界命运的终极之战，即将在此震撼上演。",
                "start": "23.31",
                "end": "32.32"
            }
        ],
        "audioUrl": "https://static-sq.qulang8.cn/static-video/2025_06_24/fddfbb1750730722875.mp3"
    }
}

Token获取

提示

欢迎关注【趣浪吧】公众号，免费获取Token