MandAPI
Español ▾
Claves y consumo

Consulta los tokens y compáralos con tu panel

Registra el uso devuelto por una respuesta de chat y compáralo con la solicitud y el cargo real de tu cuenta.

Usa esta guía con tu asistente de programación

Leer las instrucciones
Añade el registro de tokens de MandAPI a la conexión de chat existente. Lee prompt_tokens, completion_tokens y total_tokens cuando estén presentes y conserva los datos ausentes como ausentes. Registra modelo, fecha e ID de respuesta sin guardar claves ni mensajes de clientes. No inventes usage.cost, rutas generation ni reglas de facturación. Separa las estimaciones del cargo real del panel. Añade una comprobación local con una respuesta sintética; no realices una solicitud de pago sin mi autorización.
TXT

Distingue los dos registros

Una respuesta de chat puede incluir el objeto estándar usage, con tokens de entrada, salida y total. Tu panel muestra la solicitud y el cargo real de créditos. Los tokens miden el uso del modelo; no son por sí mismos un saldo monetario.

No presupongas que existe un campo monetario usage.cost ni que MandAPI tiene las mismas rutas que otra plataforma. Lee únicamente los campos que devuelve la respuesta real.

Registra una respuesta pequeña

Instala el cliente Python de OpenAI y configura MANDAPI_API_KEY y MANDAPI_MODEL_ID como indica el inicio rápido. Guarda este archivo como usage.py y ejecuta python usage.py cuando quieras realizar una solicitud real.

python
# usage.py
import os
from openai import OpenAI

with OpenAI(
    api_key=os.environ["MANDAPI_API_KEY"],
    base_url="https://api.mandapi.com/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    result = client.chat.completions.create(
        model=os.environ["MANDAPI_MODEL_ID"],
        messages=[{"role": "user", "content": "Reply with one short greeting."}],
    )
    usage = result.usage
    print({
        "response_id": result.id,
        "model": result.model,
        "prompt_tokens": usage.prompt_tokens if usage else None,
        "completion_tokens": usage.completion_tokens if usage else None,
        "total_tokens": usage.total_tokens if usage else None,
    })

El ejemplo no imprime la clave, el texto enviado ni la respuesta del modelo. Si no hay uso, guarda valores vacíos en lugar de inventar cantidades.

Compara la misma solicitud

Abre tu panel de MandAPI y localiza la solicitud por hora, modelo e identificador de respuesta cuando esté disponible. Compara los tokens con los campos que realmente muestra tu cuenta. Un identificador creado por tu aplicación ayuda en tus propios registros; no se convierte automáticamente en un campo de búsqueda de MandAPI.

Si calculas un importe con los precios publicados, anota fecha y unidades. Una estimación básica multiplica los tokens de entrada y salida por sus respectivas tarifas y divide cada cantidad entre un millón. La caché, los tramos de contexto y otras reglas del modelo pueden modificar esa estimación. Para conciliar, utiliza el cargo registrado de créditos.

Comprueba el resultado

Debes tener una solicitud fechada, un modelo, los tokens devueltos cuando existan y el registro real de la cuenta. Investiga la ausencia de uso o diferencias relevantes antes de basar un informe en esos datos. Un valor desconocido no equivale a cero.

Evita guardar prompts y mensajes de clientes en registros rutinarios de facturación. Empieza con cantidades, identificadores y estado; conserva contenido adicional solo cuando sea necesario y con acceso controlado.

Referencias

Temas inspirados en documentación pública; instrucciones y ejemplos adaptados para MandAPI.