Descripción general de la API
OfoxAI ofrece tres protocolos de acceso API, totalmente compatibles con los SDKs oficiales de cada proveedor.
Base URL
| Protocolo | Base URL | Descripción |
|---|---|---|
| Compatible con OpenAI | https://api.ofox.ai/v1 | Compatible con el SDK de OpenAI, soporta todos los modelos |
| Nativo Anthropic | https://api.ofox.ai/anthropic | Compatible con el SDK de Anthropic, experiencia nativa de Claude |
| Nativo Gemini | https://api.ofox.ai/gemini | Compatible con el SDK de Google GenAI |
Autenticación
Todos los protocolos utilizan una API Key unificada de OfoxAI, pero el formato del Header varía según el protocolo:
| Protocolo | Header | Formato |
|---|---|---|
| OpenAI | Authorization | Bearer sk-xxx |
| Anthropic | x-api-key | sk-xxx |
| Gemini | x-goog-api-key | sk-xxx |
Consulte la guía de autenticación para más detalles.
Endpoints disponibles
Protocolo compatible con OpenAI
| Endpoint | Método | Descripción |
|---|---|---|
/v1/chat/completions | POST | Crear completación de chat |
/v1/embeddings | POST | Crear embeddings de texto |
/v1/models | GET | Listar modelos disponibles |
/v1/models/{model_id} | GET | Obtener detalles del modelo |
/v1/images/generations | POST | Generación de imágenes |
Protocolo nativo Anthropic
| Endpoint | Método | Descripción |
|---|---|---|
/anthropic/v1/messages | POST | Crear Messages |
Protocolo nativo Gemini
| Endpoint | Método | Descripción |
|---|---|---|
/gemini/v1beta/models/{model}:generateContent | POST | Generar contenido |
/gemini/v1beta/models/{model}:streamGenerateContent | POST | Generar contenido en streaming |
Límites de tasa
OfoxAI funciona con pago por uso. Todos los usuarios comparten la misma política de tasa, sin diferencias por plan:
| Límite | Cuota |
|---|---|
| RPM (solicitudes/minuto) | 200 |
| TPM (tokens/minuto) | Sin límite |
Si necesita una cuota de tasa más alta, contacte al soporte de OfoxAI para solicitar un ajuste.
Cuando se activa el límite de tasa, la API retorna 429 Too Many Requests con los siguientes Headers de respuesta:
x-ratelimit-limit-requests: 200
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1sCódigos de error
Todos los protocolos retornan códigos de estado HTTP unificados:
| Código | Descripción | Causa común |
|---|---|---|
200 | Éxito | — |
400 | Error de solicitud | Formato de parámetros incorrecto, campos obligatorios faltantes |
401 | Autenticación fallida | API Key inválida o expirada |
403 | Permisos insuficientes | La cuenta no tiene acceso a este modelo |
404 | Recurso no encontrado | ID de modelo incorrecto |
429 | Límite de tasa alcanzado | Se excedió el límite de tasa |
500 | Error del servidor | Error interno, intente de nuevo |
502 | Error upstream | Servicio del proveedor de modelos con problemas |
503 | Servicio no disponible | Servicio en mantenimiento |
Formato de respuesta de error
{
"error": {
"code": "invalid_api_key",
"message": "La API Key proporcionada no es válida. Por favor, verifíquela e intente de nuevo.",
"type": "authentication_error"
}
}Parámetros extendidos de OfoxAI
OfoxAI ofrece parámetros extendidos sobre los protocolos estándar para control avanzado de enrutamiento y respaldo:
{
"model": "openai/gpt-4o",
"messages": [...],
"provider": {
"routing": "cost",
"fallback": ["anthropic/claude-sonnet-4.5", "google/gemini-3-flash-preview"]
}
}Consulte enrutamiento de proveedores y respaldo automático para más detalles.