├── README.md └── images ├── iiiLab-api-entry.jpg ├── iiiLab-api-manager.jpg └── iiiLab-homepage.jpg /README.md: -------------------------------------------------------------------------------- 1 | # iiiLab视频图片解析接口文档 2 | 3 | 此接口为通用视频图片解析接口，支持解析1000+境内外网站视频、图片、音频 4 | 5 | > API基于REST架构设计。API具有结构清晰的面向资源的URL，接收JSON格式的请求体，返回JSON格式的响应，并使用标准的HTTP响应状态码。 6 | 7 | ### 请求参数 8 | 9 | **接口地址：** `https://service.iiilab.com/openapi/extract` 10 | 11 | **请求方式：** `POST` 12 | 13 | **Content-Type：** `application/json` 14 | 15 | **请求头(Header)** 16 | 17 | 请求头|请求头说明|值举例 18 | :---|:---|:--- 19 | x-client-id|客户ID|iiiLab分配给您的客户ID|996981887a27d721 20 | x-client-secret|客户秘钥|iiiLab分配给您的客户秘钥|c4ca4238a0b923820dcc509a6f75849b 21 | 22 | 23 | **请求参数(Body)** 24 | 25 | 参数|参数说明|是否可空|值举例 26 | :---|:---|:---|:--- 27 | url|要解析的帖子页面地址|不可空|`https://weibo.com/detail/4830591038789274` 28 | 29 | ### 🟢成功返回数据 30 | 31 | > HTTP状态码为200 32 | 33 | ``` 34 | { 35 | "text": "碉堡了😳 8K HDR IMAX 杜比5.1环绕声", 36 | "medias": [ 37 | { 38 | "media_type": "video", 39 | "resource_url": "https://example.com/xyz/c4ca4238a0b923820dcc.mp4", 40 | "preview_url": "https://example.com/xyz/frame/id/c4ca4238a0b923820dcc?w=540&xcdelogo=0" 41 | }, 42 | { 43 | "media_type": "image", 44 | "resource_url": "https://example.com/v/c4ca4238a0b923820dcc.jpg" 45 | }, 46 | { 47 | "media_type": "audio", 48 | "resource_url": "https://example.com/c4ca4238a0b923820dcc.m4a", 49 | "preview_url": "https://example.com/c4ca4238a0b923820dcc.jpg", 50 | "headers": { 51 | "Referer": "https://www.sample.net/", 52 | "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36" 53 | } 54 | } 55 | ] 56 | } 57 | ``` 58 | 59 |
60 | 💡 部分网站的视频会包含多个清晰度版本，比如YouTube、FB等 [点击展开查看] 👈 61 | 62 | ``` 63 | { 64 | "text": "碉堡了😳 8K HDR IMAX 杜比5.1环绕声", 65 | "medias": [ 66 | { 67 | "media_type": "video", 68 | "resource_url": "https://example.com/video/abc123.mp4", 69 | "preview_url": "https://example.com/images/xyz789.webp", 70 | "formats": [ 71 | { 72 | "quality": 2160, 73 | "video_url": "https://example.com/video/4k/def456.webm", 74 | "video_ext": "webm", 75 | "video_size": 427472553, 76 | "audio_url": "https://example.com/audio/hij789.m4a", 77 | "audio_ext": "m4a", 78 | "audio_size": 9278232, 79 | "separate": 1, 80 | "quality_note": "4K" 81 | }, 82 | { 83 | "quality": 1440, 84 | "video_url": "https://example.com/video/2k/klm012.webm", 85 | "video_ext": "webm", 86 | "video_size": 170247698, 87 | "audio_url": "https://example.com/audio/nop345.m4a", 88 | "audio_ext": "m4a", 89 | "audio_size": 9278232, 90 | "separate": 1, 91 | "quality_note": "2K" 92 | }, 93 | { 94 | "quality": 1080, 95 | "video_url": "https://example.com/video/1080p/qrs678.mp4", 96 | "video_ext": "mp4", 97 | "video_size": 42534942, 98 | "audio_url": "https://example.com/audio/tuv901.m4a", 99 | "audio_ext": "m4a", 100 | "audio_size": 9278232, 101 | "separate": 1, 102 | "quality_note": "1080P" 103 | }, 104 | { 105 | "quality": 720, 106 | "video_url": "https://example.com/video/720p/wxy234.mp4", 107 | "video_ext": "mp4", 108 | "video_size": 15488136, 109 | "audio_url": "https://example.com/audio/zab567.m4a", 110 | "audio_ext": "m4a", 111 | "audio_size": 9278232, 112 | "separate": 1, 113 | "quality_note": "720P" 114 | }, 115 | { 116 | "quality": 480, 117 | "video_url": "https://example.com/video/480p/cde890.mp4", 118 | "video_ext": "mp4", 119 | "video_size": 8985464, 120 | "audio_url": "https://example.com/audio/fgh123.m4a", 121 | "audio_ext": "m4a", 122 | "audio_size": 9278232, 123 | "separate": 1, 124 | "quality_note": "480P" 125 | }, 126 | { 127 | "quality": 360, 128 | "video_url": "https://example.com/video/360p/ijk456.mp4", 129 | "video_ext": "mp4", 130 | "video_size": 11133410, 131 | "audio_url": null, 132 | "audio_ext": null, 133 | "audio_size": null, 134 | "separate": 0, 135 | "quality_note": "360P" 136 | }, 137 | { 138 | "quality": 240, 139 | "video_url": "https://example.com/video/240p/lmn789.mp4", 140 | "video_ext": "mp4", 141 | "video_size": 2486863, 142 | "audio_url": "https://example.com/audio/opq012.m4a", 143 | "audio_ext": "m4a", 144 | "audio_size": 9278232, 145 | "separate": 1, 146 | "quality_note": "240P" 147 | }, 148 | { 149 | "quality": 144, 150 | "video_url": "https://example.com/video/144p/rst345.mp4", 151 | "video_ext": "mp4", 152 | "video_size": 1234145, 153 | "audio_url": "https://example.com/audio/uvw678.m4a", 154 | "audio_ext": "m4a", 155 | "audio_size": 9278232, 156 | "separate": 1, 157 | "quality_note": "144P" 158 | } 159 | ] 160 | } 161 | ] 162 | } 163 | ``` 164 |
165 | 166 | **返回字段说明** 167 | 168 | | 字段 | 说明 | 是否一定有 | 169 | |--------|------|------------| 170 | | medias | 一个链接里可能包含1个或多个media | ✨一定有 | 171 | | medias -> media_type | 可能是video、image、audio | ✨一定有 | 172 | | medias -> resource_url | 视频地址(video)、图片地址(image)、音频地址(audio) | ✨一定有 | 173 | | medias -> preview_url | 视频封面(video)、音频封面(audio) | 💭可能有 | 174 | | medias -> formats | 视频多清晰度列表 | 💭可能有 | 175 | | medias -> headers | 下载resource_url时需要添加的请求头信息 | 💭可能有 | 176 | 177 | 178 | ### 🔴失败返回示例 179 | 180 | > HTTP状态码非200，比如400、422、401、402、500等 181 | 182 | ``` 183 | { 184 | "message": "链接格式错误" 185 | } 186 | ``` 187 | 188 | ### 响应HTTP状态码说明 189 | 190 | HTTP状态码|说明|返回内容示例 191 | :---|:---|:--- 192 | 200|成功|参考上述成功返回数据示例 193 | 400|业务失败|解析失败，请检查帖子链接是否包含视频图片 194 | 422|参数错误|链接格式错误 195 | 401|鉴权失败|clientId和clientSecret不匹配 196 | 402|调用次数已用完|接口调用额度已用完，请及时充值 197 | 500|未知错误|该错误一般不会遇到，如果遇到，请联系iiiLab技术支持 198 | -------------------------------------------------------------------------------- /images/iiiLab-api-entry.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iiilab-dev/post/df0730361d45d72311632c49f5d5c14cf173df05/images/iiiLab-api-entry.jpg -------------------------------------------------------------------------------- /images/iiiLab-api-manager.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iiilab-dev/post/df0730361d45d72311632c49f5d5c14cf173df05/images/iiiLab-api-manager.jpg -------------------------------------------------------------------------------- /images/iiiLab-homepage.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iiilab-dev/post/df0730361d45d72311632c49f5d5c14cf173df05/images/iiiLab-homepage.jpg --------------------------------------------------------------------------------