API 概述

OpenHuman 提供 REST API 用于与 agent 交互、管理资源和处理请求。

基础信息

项目	值
基础 URL	https://api.tinyhumans.ai/v1
认证	Bearer Token
格式	JSON
编码	UTF-8

认证

所有 API 请求需要 API 密钥：

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.tinyhumans.ai/v1/agents

速率限制

计划	限制
Free	60 请求/分钟
Pro	300 请求/分钟
Team	1000 请求/分钟

超过限制返回 429 Too Many Requests。

错误处理

错误响应格式

{
  "error": {
    "code": "invalid_api_key",
    "message": "API 密钥无效或已过期",
    "status": 401
  }
}

常见错误码

错误码	HTTP 状态	说明
invalid_api_key	401	API 密钥无效
rate_limit	429	请求超限
invalid_request	400	请求格式错误
internal_error	500	服务器内部错误
resource_not_found	404	资源不存在

版本控制

API 使用路径版本控制：

https://api.tinyhumans.ai/v1/agents
https://api.tinyhumans.ai/v2/agents  # 未来版本

下一步

• 认证机制 - API 密钥和 OAuth
• 端点列表 - 所有 API 端点
• SDK 文档 - 客户端库