Consultar saldo y cuota
Consulta cuánto puede gastar esta clave ahora mismo y su cuota; no se factura ni requiere saldo positivo.
/v1/usagebalance es lo que esta clave puede gastar ahora mismo: si la clave no tiene cuota, es el saldo de la cuenta; si la tiene, es la cuota restante de la clave. Las claves de miembros de equipo y departamentos se limitan además por la cuota restante del periodo. Una clave con cuota sigue cobrando del saldo de la cuenta: si el saldo de la cuenta se agota primero, las solicitudes devuelven 402 aunque balance aún tenga cuota.
Los importes están en USD (desde el 2026-10-01 ledger_currency es "USD", igual que unit): balance, remaining y los quota.* sin sufijo son valores en USD. Para CNY, lea los campos _cny, que contienen los mismos importes en CNY (conversión fija, no un tipo de cambio en tiempo real). Este endpoint solo acepta Authorization: Bearer y no usa la estructura de error estándar: decida según is_active, no solo por el código de estado HTTP.
Al terminar una tarea asíncrona, su consulta incluye en el usage del objeto raíz el cargo de la tarea: el importe en USD cost_usd, el importe en CNY cost y currency, la moneda de cost; cada tarea finalizada de una lista de tareas también los lleva en su usage (los campos _cny / _usd de arriba son solo de este endpoint); ver Cargos.
Encabezados
Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado
Respuesta
200Saldo y cuota; también es 200 si la clave caducó o el miembro está desactivado, con is_active: false
true si balance es mayor que 0
Lo que esta clave puede gastar ahora mismo (en USD)
Igual que balance
Siempre "USD", igual que ledger_currency
Moneda de los importes sin sufijo: "USD" (antes del 2026-10-01 era "CNY")
balance en CNY
balance en USD
Cuota de la clave
Igual que balance
Cuota restante de la clave; sin cuota, igual al saldo de la cuenta
Cuota de la clave; 0 significa sin cuota
Total cobrado acumulado de esta clave
true si la clave no tiene cuota
CNY
USD
null si no hay cuota
null si no hay cuota
null si no hay cuota
null si no hay cuota
CNY
USD
Solo en casos anómalos: api key expired, member disabled, etc.
El grupo al que pertenece esta clave; se omite en los grupos exclusivos
ID del grupo
Nombre del grupo
Nombres del grupo por idioma, con el código de idioma como clave (por ejemplo en, zh-tw, es, ja), tal como se muestran en la consola
La familia de protocolo del grupo, por ejemplo openai, claude, gemini
Errores
sk-: missing or invalid api key; clave inexistente o desactivada: invalid api key