Saltar al contenido principal
Recupere el registro de facturación de una solicitud concreta de Model API. Use este endpoint para conciliar el uso mostrado a sus usuarios, auditar costos de modelos o revisar la instantánea de precios aplicada cuando se facturó la solicitud.
Use la misma clave de API de DGrid que realizó la solicitud de modelo original. Los registros de facturación están asociados a la clave autenticada y no pueden consultarse entre claves distintas.

​
Endpoint

GET https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>
AutenticaciónAuthorization: Bearer <DGRID_API_KEY>
SolicitudParámetro de consulta
Respuestaapplication/json

​
Parámetros de consulta

ParámetroTipoObligatorioDescripción
request_idstringSíID de la solicitud completada de Model API cuyos detalles de facturación desea recuperar.

​
Obtener el ID de solicitud

DGrid devuelve el ID de solicitud en el encabezado de respuesta DGrid-Request-ID de la llamada de modelo original. Guarde este valor si necesita recuperar o conciliar los detalles de facturación más adelante. 
DGrid-Request-ID: req_178027***********6dc9x

​
Ejemplo de solicitud

curl --location \
  'https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>' \
  --header 'Authorization: Bearer <DGRID_API_KEY>'

​
Respuesta

​
200 OK

El registro de facturación existe y pertenece a la clave de API autenticada. 
{
  "code": 200,
  "message": "ok",
  "data": {
    "request_id": "req_**********86dc9x",
    "billing_json": {
      "model": "anthropic/claude-opus-4.6",
      "input_cost": 0.54909,
      "output_cost": 0.0027500000000000003,
      "cache_create_cost": 0,
      "cache_read_cost": 0,
      "request_cost": 0,
      "total_cost": 0.55184,
      "supplier_id": 1,
      "input_tokens": 109818,
      "output_tokens": 110,
      "cache_create_tokens": 0,
      "cache_read_tokens": 0,
      "pricing_mode": "usage",
      "pricing_snapshot": {
        "pricing_mode": "usage",
        "input_price_per_1m": 5,
        "output_price_per_1m": 25,
        "cache_create_price": 6.25,
        "cache_read_price": 0.5,
        "price_per_request": null,
        "input_tiers": [],
        "output_tiers": [],
        "cache_create_tiers": [],
        "cache_read_tiers": []
      }
    }
  }
}

​
Campos de facturación

CampoDescripción
modelID del modelo usado por la solicitud original.
input_tokens / output_tokensRecuento de tokens facturados por el prompt y la salida generada.
cache_create_tokens / cache_read_tokensRecuentos de tokens relacionados con caché cuando aplica la tarificación de caché.
input_cost / output_costCosto en USD atribuido al uso de tokens de entrada y salida.
cache_create_cost / cache_read_costCosto en USD atribuido a la creación y lectura de caché.
request_costCosto fijo por solicitud cuando el modo de precios incluye uno.
total_costCosto final en USD facturado por la solicitud.
pricing_snapshotConfiguración de precios usada en el momento de la facturación. Los cambios posteriores de precio no modifican este registro histórico.

​
Buenas prácticas

  • Guarde DGrid-Request-ID junto con sus propios registros de solicitudes para conciliar el uso más adelante.
  • Trate pricing_snapshot como un registro histórico inmutable de la solicitud.
  • Todos los campos de costo y precio están denominados en USD.
  • Los valores numéricos pueden tener una cantidad variable de decimales. No dependa de un formato decimal de ancho fijo.