下方示例中的
YOUR_UID / YOUR_KEY 请替换为登录后的密钥。调用方式（异步）
POST /api/v1/transcript/submit传uid、key、url（或 jxurl）→ 返回taskIdGET /api/v1/transcript/result?taskId=xxx轮询，直到status=done/failed
Java 入口需经站点反代；计费走本站 UID/KEY（预检 + 成功扣点）。联调可看产品页套餐与本说明。
本产品为专用异步接口：先
POST 提交分享链接拿到 taskId，再 GET 轮询结果。
不要走 /home/api?type=...。成功扣 1 点，失败不扣；音视频不落盘。
接口概览
| 提交地址 | https://syapi.chuangye.site/api/v1/transcript/submit |
|---|---|
| 查询地址 | https://syapi.chuangye.site/api/v1/transcript/result |
| 返回格式 | application/json |
| 流程 | ① POST 提交 → ② 用 taskId 轮询 GET → ③ status=done 取文案 |
| 计费 | 识别成功扣 1 点；失败不扣 |
① 提交任务 · POST JSON
Content-Type: application/json
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
uid | 是 | string | 用户 UID（示例：YOUR_UID） |
key | 是 | string | 接口密钥 |
url | 是 | string | 短视频完整分享链接 |
请求示例
{
"uid": "YOUR_UID",
"key": "YOUR_KEY",
"url": "https://v.douyin.com/"
}
成功响应（拿到 taskId）
{
"code": "0001",
"msg": "ok",
"taskId": "tx_xxxxxxxx"
}
② 查询结果 · GET
| 参数 | 必填 | 说明 |
|---|---|---|
taskId | 是 | 提交接口返回的任务 ID，拼在查询地址后：?taskId=... |
请求示例
GET https://syapi.chuangye.site/api/v1/transcript/result?taskId=tx_xxxxxxxx
处理中
{
"code": "0001",
"status": "processing",
"taskId": "tx_xxxxxxxx"
}
成功（status = done）
{
"code": "0001",
"status": "done",
"taskId": "tx_xxxxxxxx",
"text": "识别出的完整文案……",
"msg": "ok"
}
失败（status = failed）
{
"code": "300",
"status": "failed",
"taskId": "tx_xxxxxxxx",
"error": "失败原因",
"msg": "识别失败"
}
建议每 2 秒轮询一次，最多约 60 次；超时后可用同一 taskId 稍后再查。
常见问题
如何获取 UID / KEY？ 注册并登录后，本页「在线调试」会自动填入；也可在控制台查看。
怎么调？ 请用「在线调试」或 POST https://syapi.chuangye.site/api/v1/transcript/submit，再查 https://syapi.chuangye.site/api/v1/transcript/result。不要走 /home/api。
要传什么？ uid、key、url（完整分享链接）。
如何计费？ 成功调用扣 1 点，失败不扣；可在本页「立即购买」开通包点或包月。
有免费额度吗？ 新用户注册即可免费测试：每个独立计费产品赠送 20 次调用额度（失败不扣点），用完后需购买套餐。「共用默认池」产品与短视频共用同一份额度。