API 概述
OpenHuman 提供完整的 REST API，支持所有平台和语言。
基础信息
| 项目 | 值 |
|---|---|
| 基础 URL | https://api.openhuman.ai |
| 协议 | HTTPS |
| 格式 | JSON |
| 认证 | Bearer Token |
认证方式
所有请求需要在 Header 中包含 API 密钥：
Authorization: Bearer YOUR_API_KEY
错误处理
错误响应格式
{
"error": {
"code": "invalid_api_key",
"message": "API 密钥无效或已过期",
"details": {}
}
}
HTTP 状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 请求参数错误 |
| 401 | 认证失败 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 429 | 请求过于频繁 |
| 500 | 服务器内部错误 |
速率限制
| 套餐 | 请求限制 |
|---|---|
| 免费版 | 100 次/分钟 |
| 专业版 | 1000 次/分钟 |
| 企业版 | 10000 次/分钟 |
SDK 封装
JavaScript/TypeScript
import { OpenHuman } from 'openhuman-sdk';
const client = new OpenHuman({
apiKey: process.env.OPENHUMAN_API_KEY,
});
Python
from openhuman import OpenHuman
client = OpenHuman(api_key=os.getenv("OPENHUMAN_API_KEY"))