快速开始
5 分钟接入 OneDim API，快速完成首个调用。
- API 域名：
https://api.onedim.ai/
- 认证方式：
Bearer Token
- Header 鉴权：
Authorization: Bearer YOUR_API_TOKEN
- Token 获取路径：OneDim 控制台 -> 令牌管理
| 接口 | 方法 | 说明 |
|---|
/v1/chat/completions | POST | 聊天完成（兼容 OpenAI Chat Completions） |
/v1/models | GET | 获取模型列表 |
/v1/usage | GET | 获取用量统计 |
curl -X POST "https://api.onedim.ai/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "user", "content": "Hello, how are you?"}
],
"temperature": 0.7,
"max_tokens": 1000
}'
| 错误码 | 说明 |
|---|
401 | 认证失败，无效的 API 密钥 |
429 | 请求频率限制 |
500 | 服务器内部错误 |
503 | 服务不可用 |
{
"error": {
"message": "错误描述信息",
"type": "错误类型",
"param": "相关参数",
"code": "错误代码"
}
}
| 限制项 | 说明 |
|---|
| 请求频率 | 根据账户等级限制 |
| 单次请求最大 Token 数 | 根据模型限制 |
| 并发连接数 | 根据账户等级限制 |
| 响应超时时间 | 30 秒 |