Saltar al contenido principal

​
Lo que pagas

OrcaRouter te cobra el precio por token publicado por el proveedor upstream, sin recargo por token. Los ingresos vienen de planes de suscripción de pago opcionales, no de inflar tu coste por token.

​
El objeto usage

Cada respuesta de chat/responses incluye un campo usage: 
{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}
Los modelos de razonamiento añaden completion_tokens_details.reasoning_tokens para el pase de razonamiento oculto.

​
Cargos de herramientas integradas

Cuando la respuesta usa una herramienta integrada / del lado del servidor, la llamada se cuenta y se factura encima del uso de tokens. OrcaRouter pasa la tasa por llamada del proveedor upstream sin recargo; consulta la página de precios de cada proveedor para las tasas actuales. Herramientas que activan cargos por llamada entre proveedores:
  • OpenAI — web_search, web_search_preview, image_generation (herramientas integradas de la API Responses)
  • Anthropic — web_search (herramienta de servidor)
  • Google Gemini — anclaje googleSearch (por prompt anclado en la familia Gemini 2.x; por consulta en la familia Gemini 3.x)
  • xAI Grok — web_search, x_search, code_interpreter (API Agent Tools en /v1/responses)
Tasas específicas de OpenAI que se pasan actualmente:
HerramientaTasa por llamada
web_search$10 por 1.000 llamadas (unificado entre modelos)
web_search_preview10/1kparamodelosderazonamiento(‘o3∗‘,‘o4∗‘,‘gpt−5∗‘);10 / 1k para modelos de razonamiento (`o3*`, `o4*`, `gpt-5*`); 25 / 1k para modelos no de razonamiento (gpt-4o*, gpt-4.1*, etc.)
Para las tasas de herramientas de servidor de otros proveedores, consulta la página de precios oficial de cada proveedor.

​
Cabeceras de respuesta OrcaRouter

CabeceraCuándo se establece
X-Orca-Fallback-LevelÍndice del modelo de respaldo que sirvió la respuesta
X-Orca-Fallback-ModelNombre del modelo de respaldo
X-Orca-RouterNombre del enrutador orcarouter/{name} usado
X-Orca-Resolved-ModelModelo concreto al que se resolvió un enrutador nombrado
Ver Enrutamiento / Cabeceras de respuesta para casos de uso.

​
Consultar tu uso

El panel en orcarouter.ai/console muestra el gasto diario, el gasto total en una ventana elegida y un desglose por modelo. El panel actualmente no desglosa el gasto por clave API — los costes se agregan a nivel de espacio de trabajo. También se exponen dos endpoints de facturación en forma OpenAI para acceso programático: 
# Uso total hasta ahora (devuelve un OpenAIUsageResponse con TotalUsage)
curl https://api.orcarouter.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-orca-..."

# Cuota restante y expiración (devuelve OpenAISubscriptionResponse)
curl https://api.orcarouter.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-orca-..."
Estos son endpoints de resumen — no incluyen el desglose histórico día a día completo de OpenAI.