视频去水印API文档

【视频去水印API对接文档 - 奇云API】

## 1. 接口信息
- **请求地址**: https://qyapi.ipaybuy.cn/api/video
- **请求方法**: POST（也支持GET）
- **Content-Type**: application/json

## 2. 请求参数
| 参数名  | 类型   | 必填 | 说明                              |
|---------|--------|------|-----------------------------------|
| appId   | string | 是   | 应用ID，在奇云平台注册获取         |
| appKey  | string | 是   | 应用密钥，在奇云平台注册获取       |
| url     | string | 是   | 短视频分享链接，支持30+平台        |

## 3. 响应格式
成功响应（code=200）：
```json
{
  "code": 200,
  "msg": "解析成功",
  "data": {
    "video_url": "https://example.com/video.mp4",
    "cover_url": "https://example.com/cover.jpg",
    "title": "视频标题",
    "music_url": "https://example.com/music.mp3",
    "images": [
      {
        "url": "https://example.com/image.jpg",
        "live_photo_url": ""
      }
    ],
    "author": {
      "uid": "作者ID",
      "name": "作者昵称",
      "avatar": "https://example.com/avatar.jpg"
    },
    "content": "文案内容（小红书等平台）"
  }
}
```

## 4. 错误码说明
| 错误码 | 说明                                           |
|--------|------------------------------------------------|
| 200    | 成功                                           |
| 204    | 暂不支持该平台 / 需在APP内观看                 |
| 500    | 解析失败，链接无效或不支持该平台               |
| 1001   | 参数错误，检查appId/appKey/url                 |
| 1005   | 用户状态异常，联系客服                         |
| 3001   | 请求过于频繁，请稍后再试                       |
| 3002   | 调用次数不足，请升级套餐                       |
| 3003   | 今日调用次数已达上限，请升级套餐               |

## 5. 调用示例

### cURL
```bash
curl -X POST https://qyapi.ipaybuy.cn/api/video \
  -H "Content-Type: application/json" \
  -d '{"appId":"YOUR_APP_ID","appKey":"YOUR_APP_KEY","url":"https://v.douyin.com/xxxxx/"}'
```

### Python
```python
import requests

url = "https://qyapi.ipaybuy.cn/api/video"
headers = {"Content-Type": "application/json"}
data = {
    "appId": "YOUR_APP_ID",
    "appKey": "YOUR_APP_KEY",
    "url": "https://v.douyin.com/xxxxx/"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
```

### JavaScript
```javascript
const response = await fetch('https://qyapi.ipaybuy.cn/api/video', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    appId: 'YOUR_APP_ID',
    appKey: 'YOUR_APP_KEY',
    url: 'https://v.douyin.com/xxxxx/'
  })
});
const result = await response.json();
console.log(result);
```

### PHP
```php
<?php
$url = 'https://qyapi.ipaybuy.cn/api/video';
$data = json_encode([
    'appId' => 'YOUR_APP_ID',
    'appKey' => 'YOUR_APP_KEY',
    'url' => 'https://v.douyin.com/xxxxx/'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
?>

```

### uni-app
```javascript
uni.request({
  url: 'https://qyapi.ipaybuy.cn/api/video',
  method: 'POST',
  header: { 'Content-Type': 'application/json' },
  data: {
    appId: 'YOUR_APP_ID',
    appKey: 'YOUR_APP_KEY',
    url: 'https://v.douyin.com/xxxxx/'
  },
  success: (res) => { console.log(res.data); },
  fail: (err) => { console.error('请求失败', err); }
});
```

### 微信小程序
```javascript
wx.request({
  url: 'https://qyapi.ipaybuy.cn/api/video',
  method: 'POST',
  header: { 'Content-Type': 'application/json' },
  data: {
    appId: 'YOUR_APP_ID',
    appKey: 'YOUR_APP_KEY',
    url: 'https://v.douyin.com/xxxxx/'
  },
  success: (res) => { console.log(res.data); },
  fail: (err) => { console.error('请求失败', err); }
});
```

### Android (OkHttp)
```java
OkHttpClient client = new OkHttpClient();
JSONObject json = new JSONObject();
json.put("appId", "YOUR_APP_ID");
json.put("appKey", "YOUR_APP_KEY");
json.put("url", "https://v.douyin.com/xxxxx/");

RequestBody body = RequestBody.create(
    json.toString(),
    MediaType.parse("application/json; charset=utf-8")
);
Request request = new Request.Builder()
    .url("https://qyapi.ipaybuy.cn/api/video")
    .post(body)
    .build();

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) throws IOException {
        System.out.println(response.body().string());
    }
    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }
});
```

## 6. 支持平台（30+）
抖音、快手、小红书、视频号、微博、哔哩哔哩、今日头条、皮皮虾、微视、西瓜视频、最右、绿洲、全民K歌、美拍、新片场、好看视频、虎牙、AcFun、拼多多、火山短视频、皮皮搞笑、梨视频、度小视、逗拍、6间房、QQ浏览器短视频、百度APP短视频、某梦APP、某包APP、某问APP、汽水音乐App 等

## 7. 接入步骤
1. 在 https://qyapi.ipaybuy.cn 注册账号
2. 登录后在个人中心获取 appId 和 appKey
3. 使用上述示例代码调用接口
4. 从响应的 data.video_url 获取无水印视频地址

## 8. 注意事项
- 请确保请求频率不要过高，建议加入合理的间隔和重试机制
- 链接需要是完整的短视频分享链接（非浏览器打开后的链接）
- 视频URL可能有时效性，建议及时下载或转存
- 字段除 video_url 外，其他字段可能为空