Acceso por solicitud
El contrato de la API.
Rutas, claves y errores, para que la juzgues antes de pedir acceso.
Inicio rápido
- Solicita acceso.
- Crea tu clave.
- Cambia la dirección y la clave en tu cliente.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://criterium.pro/v1",
api_key=os.environ["CRITERIUM_API_KEY"],
)
r = client.chat.completions.create(
model="criterium/router",
messages=[
{"role": "user", "content": "Resume esta factura."},
],
)
print(r.choices[0].message.content)
Solo cambian las líneas marcadas.
Contrato
Forma compatible con el ecosistema OpenAI.
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /v1/models | Los modelos que funcionan con tu clave. |
| POST | /v1/chat/completions | Respuesta completa o por eventos (streaming). |
Autenticación
Una clave por cabecera, con el prefijo a la vista.
Clave de ejemplocrit_sk_
- Se enseña una sola vez, al crearla.
- Solo guardamos su resumen y su prefijo.
- Cuotas y presupuesto van por organización.
Errores
Códigos en la forma de error del ecosistema OpenAI.
| Estado | Código | Cuándo |
|---|---|---|
| 401 | invalid_api_key | Clave ausente, mal escrita o revocada. |
| 402 | budget_exceeded | Has agotado el presupuesto de tu organización. |
| 404 | model_not_found | El modelo no existe o no está disponible para tu clave. |
| 429 | rate_limit_exceeded | Has pasado la cuota de tu organización. |
| 502 | upstream_error | El proveedor del modelo ha fallado. |