222 API文档
概述
提示:在使用API之前,请先注册账号并获取API密钥。
认证方式
本API采用API Key + Secret的认证方式,需要在请求头中携带以下字段:
| Header名称 | 说明 | 示例 |
|---|---|---|
X-API-Key |
API密钥 | ak_xxxxxxxxxxxx |
X-API-Secret |
API密钥密文 | sk_xxxxxxxxxxxx |
API端点
GET
http://wuchai.net/api/v1/ai/api
请求参数
Header参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
string | 是 | API密钥 |
X-API-Secret |
string | 是 | API密钥密文 |
Query参数
具体业务参数请根据实际需求传递,常见参数包括:
param1- 参数1说明param2- 参数2说明
调用示例
cURL
curl -X GET \
"http://wuchai.net/api/v1/ai/api" \
-H "X-API-Key: YOUR_API_KEY" \
-H "X-API-Secret: YOUR_API_SECRET"
JavaScript (Axios)
const axios = require('axios');
const response = await axios({
method: 'get',
url: 'http://wuchai.net/api/v1/ai/api',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'X-API-Secret': 'YOUR_API_SECRET'
}
});
console.log(response.data);
Python
import requests
response = requests.get(
'http://wuchai.net/api/v1/ai/api',
headers={
'X-API-Key': 'YOUR_API_KEY',
'X-API-Secret': 'YOUR_API_SECRET'
}
)
print(response.json())
响应格式
成功响应
{
"success": true,
"data": {
// 业务数据
},
"meta": {
"request_id": "req_xxxxxx",
"response_time": 0.123
}
}
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
success |
boolean | 请求是否成功 |
data |
object | 业务数据 |
meta.request_id |
string | 请求ID,用于问题排查 |
meta.response_time |
number | 响应时间(秒) |
错误码
| 错误码 | HTTP状态 | 说明 |
|---|---|---|
MISSING_API_KEY |
401 | 缺少API密钥 |
INVALID_API_KEY |
401 | 无效的API密钥 |
INVALID_API_SECRET |
401 | API密钥错误 |
API_KEY_DISABLED |
403 | API密钥已禁用 |
API_KEY_EXPIRED |
403 | API密钥已过期 |
DAILY_QUOTA_EXCEEDED |
429 | 超出每日配额 |
RATE_LIMIT_EXCEEDED |
429 | 速率限制超限 |
SERVICE_NOT_FOUND |
404 | 服务不存在 |
SERVICE_ERROR |
500 | 服务处理失败 |
限制说明
速率限制
默认每分钟60次请求,可根据套餐调整
每日配额
根据套餐不同,每日可调用100-10000次
并发限制
同一密钥最多10个并发请求
超时时间
请求超时时间为30秒