TikTok视频下载
最低 ¥0.03/次起即将上线需配置 API KeyTikTok视频下载
单价随接口累计调用量阶梯调整
POST
https://redfox.hk/story/api/parseWork/videoDownload/tiktokAPI 密钥获取与配置
获取密钥调用 API 前,请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段,密钥用于身份校验与额度计费。
获取步骤
- 前往控制台页面,进入 API 密钥管理模块。
- 若无已生成的密钥,点击生成新密钥,复制并妥善保存密钥。
- 在请求头中添加
REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。
API说明
Method:POST
Host:https://redfox.hk
Path:/story/api/parseWork/videoDownload/tiktok
请求头
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| REDFOX_API_KEY | string | 是 | 平台鉴权令牌,每次请求必填 | ak_xxxxxx |
| Content-Type | string | 是 | 请求体数据类型 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | String | 是 | 视频链接 | https://www.tiktok.com/@koji_japanese_food/video/7636776450875591957?is_from_webapp=1&sender_device=pc |
返回值与结构
统一包装一般为 `code`、`message`/`msg`、`data`(以实际服务为准)。
响应字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| cover | String | 封面地址 | |
| coverUrl | String | 封面链接 | |
| desc | String | 内容 | |
| downloadUrl | String | 下载链接 | |
| durationSeconds | Integer | 时长(秒) | |
| resources | Array | 全部媒体资源列表(视频、音频、图片等) | |
| title | String | 标题 | |
| type | String | 资源类型:video-视频, audio-音频, mp3-音频, image-图片 | |
| videoUrl | String | 视频下载地址 |
请求示例
请求参数:
{
"url": "https://www.tiktok.com/@koji_japanese_food/video/7636776450875591957?is_from_webapp=1&sender_device=pc"
}响应示例
{
"code": 2000,
"data": {
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oYYVD0fD4QjtjQTIIkfsneX02CAA4EcSFEOgQA~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=ad556575&x-expires=1784880000&x-signature=Hp%2FiaD5OTuw71Ba1nkln394uyGY%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&sc=feed_cover&biz_tag=tt_video",
"resources": [
{
"coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oYYVD0fD4QjtjQTIIkfsneX02CAA4EcSFEOgQA~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=ad556575&x-expires=1784880000&x-signature=Hp%2FiaD5OTuw71Ba1nkln394uyGY%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&sc=feed_cover&biz_tag=tt_video",
"downloadUrl": "https://v16.tokcdn.com/c4c19b6e015f0f477cae4a717527f069/69fa8480/7636776450875591957_original.mp4",
"durationSeconds": 60,
"type": "video"
},
{
"coverUrl": "https://p19-common.tiktokcdn-us.com/tos-alisg-v-2774/oUMEIedrVGI6eAAAQ98KeLFjiMAB9IPsNee2RA~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=d05b14bd&idc=useast5",
"downloadUrl": "https://v19-ies-music.tiktokcdn-us.com/b3506467aee5afe8d5d45f6835af5564/6a6b0d5b/video/tos/alisg/tos-alisg-ve-2774/oMplQodfkByIZCFZ1BmMlaZHgntLgJfi1GkDEM/?a=583965&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=64&ft=B7czJVY1wyqRft9EOr_hFJ4_A0pisIiJQjKJzi4YAG0P3-I&mime_type=audio_mp4&rc=aTg6OWgzOTxoNTw0OTs4NEBpM2xoc3Q5cjxzOTMzODlkNEBfMjYtLS8vNWMxMWIzYy5fYSMzYTZzMmQ0MGJhLS1kYS1zcw%3D%3D&vvpl=1&l=20260723083547496A8EAE2AA3DD2E6D71&btag=e00090000&shp=d05b14bd&shcp=-",
"durationSeconds": 60,
"type": "audio"
}
],
"title": "都内唯一の屋台ラーメン🍜 ◆チャーシュー麺 (¥950) [トッピング] 味玉 (¥100) 玉ねぎ (¥50) 海苔 (¥50) ほうれん草 (¥100) 八王子にある都内で唯一の屋台ラーメン! 都心から離れているのに行列のできる人気店 日本ならではの屋台ラーメンは趣のある雰囲気と一度食べたら忘れられない味 カウンター席とテーブル席があるがカウンター席は予約することも可能。(詳しくはお店のアカウントをチェック) ≪店舗詳細≫ 【店舗名】屋台ラーメン しゅんやっちゃん 【住所】東京都八王子市初沢町1277-8 【営業時間】18:00〜23:00 【定休日】月曜・日曜 #東京グルメ #八王子グルメ #屋台ラーメン ==================================== Tokyo’s Only Yatai Ramen Stand in the City 🍜 ◆ Chashu Ramen (¥950) [Toppings] Ajitama Egg (¥100) Onion (¥50) Nori Seaweed (¥50) Spinach (¥100) A one-of-a-kind yatai-style ramen stand in Tokyo, located in Hachioji! Even though it’s far from central Tokyo, people line up for this incredibly popular spot. This traditional Japanese street-style ramen offers a nostalgic atmosphere and an unforgettable flavor you’ll keep craving. There are both counter and table seats available, and you can even reserve the counter seats in advance. (Check the shop’s account for details!) ≪Shop Information≫ 【Shop Name】Shunyacchan Yatai Ramen 【Address】1277-8 Hatsuzawamachi, Hachioji, Tokyo 【Hours】18:00–23:00 【Closed】Mondays & Sundays #japanesefood ",
"videoUrl": "https://v16.tokcdn.com/c4c19b6e015f0f477cae4a717527f069/69fa8480/7636776450875591957_original.mp4"
},
"msg": "成功"
}常见状态码说明
调用接口时,响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。
| 状态码 | 说明 | 排查建议 |
|---|---|---|
400 | 请求参数错误 | 检查请求体、Query 参数是否与文档一致,必填项是否齐全。 |
401 | 鉴权失败 | 确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY,且密钥有效、未禁用。 |
403 | 无权限访问 | 当前密钥或账号无权调用该接口,请检查密钥状态与接口权限。 |
500 | 系统内部错误 | 服务端异常,请稍后重试;持续出现请联系技术支持。 |
503 | 服务暂不可用 | 服务维护或短暂过载,请间隔一段时间后重试。 |
1001 | 缺少必要参数 | 对照「请求参数」表,补全必填字段。 |
1002 | 参数格式不正确 | 检查字段类型与格式(如 URL、日期、枚举值)是否符合说明。 |
1003 | 参数类型错误 | 确认 JSON 中数字、字符串、布尔等类型与文档定义一致。 |
3103 | 密钥不存在 | 密钥可能已删除或填写错误,请前往控制台核对并重新复制。 |
3105 | API Key 已禁用 | 在控制台启用该密钥,或创建新密钥后替换请求头中的值。 |
3201 | 积分不足 | 账户余额不足以支付本次调用,请前往控制台充值后再试。 |
3202 | 积分账户不存在 | 账号积分账户异常,请登录控制台确认账户状态。 |
4004 | 操作过于频繁,请稍后再试 | 触发频率限制,降低请求频率或增加调用间隔后重试。 |