API 文档

抓取大师 v4 接口：输入网页 / APP 分享链接，返回图片或视频地址数组。支持 Agent Skill 一键下载。

标准 SKILL.md，可供 AI Agent 加载后直接调用

基础信息

站点https://url2pic.php127.com
API 根https://url2pic.php127.com/api
统一抓取POST /api/v4/go
任务中心POST /api/v2/job-center/submitPOST /api/v2/job-center/list

鉴权

所有需登录接口须同时携带：

请求体签名 Sign：md5(JSON.stringify(body)).slice(0, 10)
身份凭证（二选一）：请求头 Key（API Key）或 Token（登录 Token）

Content-Type: application/json
Key: u2p5f582fxxxxxxxxxc49a50dbda
Sign: 3a8ee6a1b2

API Key 可在会员中心「API Key」页面生成 / 重置。未携带或无效返回 code=10001 / 10002。

统一抓取入口 POST /api/v4/go

请求体

字段	类型	必填	说明
`from`	string	是	前端入口，见下表。只记录页面，不决定图集或视频
`urls`	string \| string[]	是	一或多个链接，最多 10 个

from 取值

from	说明	适用链接
`web`	网页图片	任意网页
`css`	CSS 图片	CSS 文件地址
`js`	JS 图片	JS 文件地址
`api`	API 图片	接口地址
`mp_weixin`	微信公众号文章	mp.weixin.qq.com/s/*
`douyin_image`	抖音图集入口	douyin.com 分享链接
`douyin_video`	抖音视频入口	douyin.com 分享链接
`kuaishou_image`	快手图集入口	kuaishou.com 分享链接
`kuaishou_video`	快手视频入口	kuaishou.com 分享链接
`xiaohongshu_image`	小红书图集入口	xiaohongshu.com / xhslink.com
`xiaohongshu_video`	小红书视频入口	xiaohongshu.com / xhslink.com
`doubao`	豆包 AI 生图分享页	doubao.com/thread/*
`qianwen`	千问 AI 生图分享页	qianwen.com/share/*

链接能识别平台时按链接解析，from 只记录入口。图集或视频看响应里的 content_type。

响应结构

{
  "code": 1,
  "msg": "success",
  "data": {
    "all_url": ["https://...", "https://..."],
    "list": [
      {
        "id": 12345,
        "type": "webpic.douyin",
        "url": "https://v.douyin.com/xxxx",
        "content_type": "image",
        "list": ["https://...", "https://..."],
        "media": {
          "platform": "douyin",
          "title": "标题",
          "cover": "https://...",
          "videos": [{ "url": "https://...", "quality": "1080p" }]
        }
      }
    ],
    "errors": [],
    "usage_count": 12
  }
}

all_url：全部资源地址（去重合并）
list[].type：形如 webpic.<subtype>，可作为任务中心打包 job
list[].list：该组资源地址；content_type 为 image / video
errors：逐条失败原因；usage_count：当前用户已用次数

调用示例

cURL

curl -X POST https://url2pic.php127.com/api/v4/go \
  -H 'Content-Type: application/json' \
  -H 'Key: YOUR_API_KEY' \
  -H 'Sign: 3a8ee6a1b2' \
  -d '{"from":"douyin_image","urls":"https://v.douyin.com/xxxx"}'

Node.js

const body = JSON.stringify({ from: 'qianwen', urls: 'https://www.qianwen.com/share/chat/xxxx' });
const sign = require('crypto').createHash('md5').update(body).digest('hex').slice(0, 10);
const res = await fetch('https://url2pic.php127.com/api/v4/go', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Key: 'YOUR_API_KEY', Sign: sign },
  body,
});
const json = await res.json();
const images = json.data.list.flatMap((g) => g.list);

任务中心（打包下载）

通过 list[].type + list[].id 提交打包任务：

POST /api/v2/job-center/submit
{ "job": "webpic.douyin", "params": { "id": 12345 } }

// 通用图片打包
{ "job": "zip", "params": { "urls": ["https://..."] } }

注意事项

from 记录入口页面。链接能识别平台时以链接为准。
单次最多 10 个链接。
图片地址可能经代理重写，直接使用返回地址即可下载。
豆包 / 千问抓取返回无水印原图。