API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

视频号作品objectId获取视频号视频链接

最低 ¥0.03/次起即将上线

先通过objectId换取视频号短链，再解析短链返回标题、封面、视频下载地址

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/sph/ability/objectIdToVideoUrl

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

前往控制台页面，进入 API 密钥管理模块。
若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/sph/ability/objectIdToVideoUrl

请求头

名称	类型	必填	说明	示例
REDFOX_API_KEY	string	是	平台鉴权令牌，每次请求必填	ak_xxxxxx
Content-Type	string	是	请求体数据类型	application/json

请求参数

参数	类型	必填	说明	示例
objectId	string	否	视频号作品objectId 必填	14964503453899164167

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段	类型	说明	示例
cover	string	封面地址（取自首个视频媒体的封面）	https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200
desc	string	内容
resources	array	全部媒体资源列表（视频、音频、图片等）
coverUrl	string	封面链接	https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200
downloadUrl	string	下载链接	https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ
durationSeconds	integer	时长（秒）
type	string	资源类型：video-视频, audio-音频, mp3-音频, image-图片	video
title	string	标题	那远方在呼唤我！寻一片旷野，听风穿过山谷，以山为友，以川为伴，用脚步丈量每一道山脊，用镜头记录每一个瞬间。感受独属于自己的自由！#旅行 #航拍 #山川作伴 #山野治愈 #旅行氛围感 #奔赴山河#川西#贡嘎雪山#旅行 #pgytech#去有风的地方＃那远方在呼唤我＃摄影#为山峰做一次创作 #山不见我我去见山 #自由与远方#大疆镜头下的松弛感
videoUrl	string	视频下载地址（取自首个视频类型的下载链接）	https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ

请求示例

{
  "objectId": "14964503453899164167"
}

响应示例

{
  "code": 2000,
  "data": {
    "cover": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200",
    "desc": null,
    "resources": [
      {
        "coverUrl": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200",
        "downloadUrl": "https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ",
        "durationSeconds": null,
        "type": "video"
      }
    ],
    "title": "那远方在呼唤我！寻一片旷野，听风穿过山谷，以山为友，以川为伴，用脚步丈量每一道山脊，用镜头记录每一个瞬间。感受独属于自己的自由！#旅行 #航拍 #山川作伴 #山野治愈 #旅行氛围感 #奔赴山河#川西#贡嘎雪山#旅行 #pgytech#去有风的地方＃那远方在呼唤我＃摄影#为山峰做一次创作 #山不见我我去见山 #自由与远方#大疆镜头下的松弛感",
    "videoUrl": "https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ"
  },
  "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`	操作过于频繁，请稍后再试	触发频率限制，降低请求频率或增加调用间隔后重试。

调用步骤

在请求头配置REDFOX_API_KEY或X-API-KEY
按 API 说明示例构造请求参数或请求体。
发起请求。
解析 JSON 响应中的 code、message 与 data 字段。

Request（示例代码，仅供参考）

bash

curl -X POST "https://redfox.hk/story/api/sph/ability/objectIdToVideoUrl" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "objectId": "14964503453899164167"
}'

Response（示例代码，仅供参考）

json

{
  "code": 2000,
  "data": {
    "cover": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200",
    "desc": null,
    "resources": [
      {
        "coverUrl": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=2fG3V4WwQPkqUpiaG5XdeLy737Xel1Fiahd0OuwkWSO44qzE2D3tzDhQ1I5nzqkknYnrVAcm1EWhUWrl4LcYR9cdM9foXuIpzFdeuoOse5ReI&token=Cvvj5Ix3eezy5qZNI6uMRIhCzUHGnNiaKiaFXBZMK6GGnGXAsEkz9KwAgcoWOsYsv41bJtKD3PnkUgFJOna5LcoCMvqjI5GOwabdFJcAOOnZyib42NLcYuvHs2OAhDUknDP8iba8lvyZ8qh0JibNI7RyMl0ibALwYAr1ZWzHEia4uKhk5r0xXQDia9u557fPFBJteZM9dKREeJCKF01ib84PfaA6iaJwtOY2hP5QxKKWn2cDGzSF4&hy=SH&idx=1&m=b0553cd6d0a3d40d08efb7db672fee12&uzid=1&wxampicformat=503&picformat=200",
        "downloadUrl": "https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ",
        "durationSeconds": null,
        "type": "video"
      }
    ],
    "title": "那远方在呼唤我！寻一片旷野，听风穿过山谷，以山为友，以川为伴，用脚步丈量每一道山脊，用镜头记录每一个瞬间。感受独属于自己的自由！#旅行 #航拍 #山川作伴 #山野治愈 #旅行氛围感 #奔赴山河#川西#贡嘎雪山#旅行 #pgytech#去有风的地方＃那远方在呼唤我＃摄影#为山峰做一次创作 #山不见我我去见山 #自由与远方#大疆镜头下的松弛感",
    "videoUrl": "https://finder.video.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewQsFvYyicia1J4UVWic3vGEdVlPkPFn0YOUk3mQtsL91icibbicyBlYfPV0k37ricdzY8ib2ERo68icz1DjtAlC7bwGm4P2icQX6kr6X2blCMsGnuykfBw&token=Cvvj5Ix3eezy5qZNI6uMRLBLyIL9juLuMQ8YgDic2DoYhl2SSj5JPke4YrHcFHzqUPSVZHS1aZj2neibAFeiaTC1D8XwEBfFWM2VOM3wLcOnYyFEicdaB89a6cWgptHR7TkLF7xEJZPM5vQlvC53ScextVG87TvLp8t2v93ia0Xza0OXoyyNmThHXFiapFz9crzjkgjM5h4rdWZyGgOu8RWJEDTIelNZXmEVvq4aPWeLuibDK0&hy=SH&idx=1&m=1e586db4f4e47f296e42a3546f122c43&uzid=7a152&X-snsvideoflag=xWR113&basedata=CAMSBnhXUjExMyIMCgoKBnhXUjExMxAAOgIIAkIgYIuB1isR5S9PwpjMYDFs_N7v4r9EdsusyEHTVkAgsAZIn-6l1wY&sign=sLIAjJB_7Mf-yIyzQp6ZJxQ14OPABpKG_Av1iKxHPjRvvyoyb1cxJ8CmAlb40zG1am3OSXUjS7MjgQjr87TnoQ"
  },
  "msg": "成功"
}