API Overview
OpenHuman provides a REST API for interacting with agents, managing resources, and processing requests.
Base Information
| Item | Value |
|---|---|
| Base URL | https://api.tinyhumans.ai/v1 |
| Authentication | Bearer Token |
| Format | JSON |
| Encoding | UTF-8 |
Authentication
All API requests require an API key:
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
https://api.tinyhumans.ai/v1/agents
Rate Limits
| Plan | Limit |
|---|---|
| Free | 60 requests/minute |
| Pro | 300 requests/minute |
| Team | 1000 requests/minute |
Requests exceeding the limit return 429 Too Many Requests.
Error Handling
Error Response Format
{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid or expired",
"status": 401
}
}
Common Error Codes
| Error Code | HTTP Status | Description |
|---|---|---|
invalid_api_key | 401 | API key is invalid |
rate_limit | 429 | Rate limit exceeded |
invalid_request | 400 | Invalid request format |
internal_error | 500 | Internal server error |
resource_not_found | 404 | Resource not found |
Versioning
API uses path-based versioning:
https://api.tinyhumans.ai/v1/agents
https://api.tinyhumans.ai/v2/agents # Future version
Next Steps
- Authentication - API key and OAuth
- Endpoints - All API endpoints
- SDK Documentation - Client libraries