全网视图下载 API 文档

POST https://a.jiejing.fun/parse
Content-Type: application/json

{
  "url": "https://v.douyin.com/EsoUSq6vzRQ/",
  "kl": "你的授权码",
  "type": "hdr"
}

https://a.jiejing.fun/parse?url=https%3A%2F%2Fv.douyin.com%2FEsoUSq6vzRQ%2F

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://v.douyin.com/EsoUSq6vzRQ/"}'

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://v.douyin.com/EsoUSq6vzRQ/","kl":"你的授权码","type":"hdr"}'

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"http://xhslink.cn/o/示例短链","key":"你的无限Key","type":"hd"}'

ffmpeg -version

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://www.bilibili.com/video/BVxxxxxxxxxx","kl":"你的授权码","type":"hd"}'

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://www.douyin.com/user/作者sec_user_id","type":"home","count":60}'

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"复制这段内容打开抖音 https://v.douyin.com/EsoUSq6vzRQ/ 查看作品"}'

{
  "code": 0,
  "msg": "解析成功✅一共1个视频",
  "total": 10,
  "remaining": 9,
  "urls": ["https://example-cdn.com/video.mp4"],
  "Referer": "https://www.douyin.com/",
  "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) ...",
  "Accept": "*/*"
}

{
  "code": 0,
  "msg": "解析成功✅一共 2 个可合并视频规格",
  "urls": [
    "justlive://merge?video=https%3A%2F%2Fexample.com%2Fvideo.m4s&audio=https%3A%2F%2Fexample.com%2Faudio.m4s"
  ],
  "body": {
    "title": "视频标题",
    "merges": {
      "4K（1.20GB）": "justlive://merge?video=...&audio=...",
      "1080P（320MB）": "justlive://merge?video=...&audio=..."
    }
  },
  "Referer": "https://www.bilibili.com/",
  "User-Agent": "Mozilla/5.0 ...",
  "Accept": "*/*"
}

{
  "code": 0,
  "msg": "成功获取第 1-20 条作品，共 20 个",
  "urls": [
    "https://example-cdn.com/video.mp4",
    "https://example-cdn.com/image-1.jpg",
    "https://example-cdn.com/image-2.jpg"
  ],
  "body": [
    {
      "id": "7667408696426679588",
      "type": "video",
      "title": "将近三万包月拿下蔚来ES9，今天聊聊电动门",
      "time": 1785236400,
      "url": "https://example-cdn.com/video.mp4",
      "cover_url": "https://example-cdn.com/cover.jpeg"
    },
    {
      "id": "7667408696426679000",
      "type": "images",
      "title": "这是一个抖音图集作品",
      "time": 1785236300,
      "count": 2,
      "urls": [
        "https://example-cdn.com/image-1.jpg",
        "https://example-cdn.com/image-2.jpg"
      ]
    }
  ],
  "Referer": "https://www.douyin.com/",
  "User-Agent": "Mozilla/5.0 ...",
  "Accept": "*/*"
}

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://v.douyin.com/EsoUSq6vzRQ/"}' \
  | jq -r 'if .code == 0 then .urls[] else .msg end'

export QSY_KL='你的授权码'

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data "$(jq -n --arg url 'https://v.douyin.com/EsoUSq6vzRQ/' --arg kl "$QSY_KL" \
    '{url: $url, kl: $kl, type: "hd"}')" \
  | jq .

response_file="$(mktemp)"

curl -sS 'https://a.jiejing.fun/parse' \
  -H 'Content-Type: application/json' \
  --data "$(jq -n --arg url 'https://v.douyin.com/EsoUSq6vzRQ/' --arg kl "${QSY_KL:-}" \
    '{url: $url, kl: $kl}')" \
  > "$response_file"

referer="$(jq -r '.Referer // ""' "$response_file")"
user_agent="$(jq -r '."User-Agent" // ""' "$response_file")"
accept="$(jq -r '.Accept // ""' "$response_file")"

header_args=()
[[ -n "$referer" ]] && header_args+=(-H "Referer: $referer")
[[ -n "$user_agent" ]] && header_args+=(-H "User-Agent: $user_agent")
[[ -n "$accept" ]] && header_args+=(-H "Accept: $accept")

index=0
jq -r '.urls[]' "$response_file" | while IFS= read -r media_url; do
  index=$((index + 1))
  curl --fail --location --retry 2 \
    "${header_args[@]}" \
    --output "qsy-download-$index" \
    "$media_url"
done

rm -f "$response_file"

$body = @{
  url  = "https://v.douyin.com/EsoUSq6vzRQ/"
  kl   = "你的授权码"
  type = "hd"
} | ConvertTo-Json

$result = Invoke-RestMethod `
  -Method Post `
  -Uri "https://a.jiejing.fun/parse" `
  -ContentType "application/json" `
  -Body $body
if ($result.code -eq 0) {
  $downloadHeaders = @{}
  if ($result.Referer) { $downloadHeaders["Referer"] = $result.Referer }
  if ($result."User-Agent") { $downloadHeaders["User-Agent"] = $result."User-Agent" }
  if ($result.Accept) { $downloadHeaders["Accept"] = $result.Accept }

  for ($i = 0; $i -lt $result.urls.Count; $i++) {
    Invoke-WebRequest `
      -Uri $result.urls[$i] `
      -Headers $downloadHeaders `
      -OutFile ("qsy-download-{0}" -f ($i + 1))
  }
} else {
  Write-Error $result.msg
}

curl.exe "https://a.jiejing.fun/parse" `
  -H "Content-Type: application/json" `
  --data-raw '{"url":"https://v.douyin.com/EsoUSq6vzRQ/","type":"hd","kl":"你的授权码"}'

import requests

response = requests.post(
    "https://a.jiejing.fun/parse",
    json={
        "url": "https://v.douyin.com/EsoUSq6vzRQ/",
        "type": "hd",
        "kl": "你的授权码",
    },
    timeout=260,
)
response.raise_for_status()
data = response.json()

if data.get("code") != 0:
    raise RuntimeError(data.get("msg", "解析失败"))

download_headers = {
    key: data.get(key)
    for key in ("Referer", "User-Agent", "Accept")
    if data.get(key)
}

for index, download_url in enumerate(data.get("urls", []), start=1):
    with requests.get(
        download_url,
        headers=download_headers,
        stream=True,
        timeout=260,
    ) as media:
        media.raise_for_status()
        with open(f"qsy-download-{index}", "wb") as output:
            for chunk in media.iter_content(chunk_size=1024 * 256):
                if chunk:
                    output.write(chunk)

收到社交平台分享链接或分享文案后，优先使用 POST https://a.jiejing.fun/parse。
请求使用 application/json，把原始文本完整放入 url 字段；默认不传 type。
用户明确要求高清、HDR 或抖音主页时，分别传 type=hd、type=hdr、type=home。
哔哩哔哩高清使用 type=hd；调用 API 前先运行 ffmpeg -version，未安装时先停止并指导用户安装。
仅当 code=0 时视为成功，最终下载地址只读取顶层 urls 数组。
哔哩哔哩高清的 justlive://merge 不是普通下载链接；解析 video 和 audio，分别下载后用 FFmpeg 合并，默认选择最高规格。
抖音主页批量解析如果需要按作品标题命名，必须遍历 body：视频下载 item.url，图集下载 item.urls。
下载每个 urls 地址时，必须携带响应中的 Referer、User-Agent、Accept 请求头；空字段可省略。
解析失败时必须向用户展示 msg 和 list，不要只显示“请求失败”。
免费额度不足时引导用户获取授权码；已有授权码次数不足时引导用户给当前授权码补充次数。
授权码用户同样优先消耗当天免费的 10 次额度，用完后才扣授权码次数；带 kl 请求次数不足时不要删掉 kl 改用免费模式重试，直接引导充值当前授权码。
code=500 时向用户提供解析需求提交入口。
不得猜测或泄露 kl、key，也不要把授权凭据写入日志。

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://a.jiejing.fun/parse', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    url: 'https://v.douyin.com/EsoUSq6vzRQ/',
    type: 'hd',
    kl: process.env.QSY_KL || ''
  }),
  signal: AbortSignal.timeout(260000)
});
const data = await response.json();

if (!response.ok || data.code !== 0) {
  throw new Error(data.msg || `HTTP ${response.status}`);
}

const downloadHeaders = Object.fromEntries(
  ['Referer', 'User-Agent', 'Accept']
    .filter((name) => data[name])
    .map((name) => [name, data[name]])
);

for (const [index, mediaUrl] of data.urls.entries()) {
  const mediaResponse = await fetch(mediaUrl, { headers: downloadHeaders });
  if (!mediaResponse.ok) {
    throw new Error(`下载失败：HTTP ${mediaResponse.status}`);
  }
  await writeFile(`qsy-download-${index + 1}`, Buffer.from(await mediaResponse.arrayBuffer()));
}

https://mai.huiyuan.site/?code=你的授权码

https://a.jiejing.fun/request?url=ENCODED_URL