API文档

从零到第一个转换完成的文件：

1. 在 1-converter.com 选择付费套餐（Starter、Pro 或 Business）。免费版不提供 API 密钥。
2. 在“控制台 → 设置 → API 密钥”中创建密钥并复制：它只显示一次。
3. 按照“身份验证”部分的说明，在第一次上传时附上密钥。

每个请求都要带上你的 API 密钥，放在下面任意一个请求头中：

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

两个请求头都可以使用，携带的是同一个密钥，选你的 HTTP 客户端更方便的那个即可。

切勿分享你的 API 密钥，也不要把它提交到版本控制中。

确保您的 API 密钥安全，切勿在客户端代码中公开它。

所有 API 请求均应发送至：

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

每个付费套餐都包含每月的 API 调用次数，与价格页面上显示的一致。

当超出速率限制时，您将收到 429 Too Many Requests 响应。

API 使用标准 HTTP 状态代码来指示成功或失败：

以下是不同编程语言的示例：

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Python

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

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

卷曲

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"