FAQ

TokSpan es un gateway unificado de API de IA que le brinda un único endpoint compatible con OpenAI para acceder a más de 200 modelos de más de 50 proveedores — incluyendo OpenAI, Anthropic, Google, Meta, DeepSeek y más.

Así funciona: usted envía solicitudes a la API de TokSpan en formato estándar de OpenAI. TokSpan enruta su solicitud al proveedor upstream correspondiente, traduce el formato si es necesario, gestiona la respuesta y se la devuelve. Desde su perspectiva, usted llama a una sola API — TokSpan gestiona el enrutamiento de modelos, balanceo de carga, límites de tasa, failover automático y seguimiento de costos en segundo plano.

Solo necesita una cuenta de TokSpan. Nosotros gestionamos todas las relaciones con los proveedores upstream en su nombre — no se requieren cuentas separadas con OpenAI, Anthropic o Google.

• Una clave, todos los modelos — Acceda a GPT-4o, Claude Opus, Gemini Pro y DeepSeek V3 con una sola clave API. Sin gestionar múltiples cuentas de facturación en diferentes proveedores.
• Sin dependencia de un proveedor — Cambie de modelo modificando un solo parámetro. Su código permanece igual sin importar qué proveedor atienda la solicitud.
• Failover automático — Si un proveedor falla, el tráfico se enruta automáticamente a su modelo de respaldo. Cero intervención manual.
• Alcance global — Una red edge global que sirve a desarrolladores de todo el mundo.
• Visibilidad de costos — Facturación unificada y seguimiento de uso en tiempo real de todos los modelos y proveedores en un solo panel.

Comenzar toma aproximadamente 5 minutos:

1. Regístrese en api.tokspan.com/register
2. Agregue créditos a su cuenta mediante tarjeta de crédito, PayPal o transferencia bancaria
3. Cree una clave API desde la página Panel → API Keys
4. Haga su primera llamada — solo cambie base_url a https://api.tokspan.com/v1 y use su nueva clave

Si ya usa el SDK de OpenAI, está a 30 segundos. Consulte la guía de Inicio Rápido para ejemplos de código en Python, TypeScript y curl.

No ofrecemos un nivel gratuito permanente — por eso es realmente bueno para usted:

• Sin degradación de calidad subsidiada — Los niveles gratuitos a escala requieren recortar en infraestructura, soporte o acceso a modelos. Nosotros invertimos todo en fiabilidad y cobertura de modelos.
• Pague solo por lo que use — Sin compromiso mínimo. Recargue tan poco como necesite. La mayoría de los desarrolladores gastan menos de $5 en su primer mes de prueba.
• Todos los modelos, sin restricciones — Su saldo de pago le da acceso inmediato a todos los modelos de frontera en la plataforma — sin limitaciones de "solo nivel gratuito".

Las cuentas nuevas pueden recibir créditos promocionales de inicio ocasionalmente. Consulte el Panel después de registrarse.

Brindamos acceso a más de 200 modelos en todas las categorías principales: LLMs (GPT-4o, Claude Opus 4.8, Gemini 2.5 Pro, DeepSeek V3, Llama 4, Mistral Large 3), Visión y Multimodal, Embeddings y Reranking, y Voz y Audio (TTS + STT).

Explore el catálogo completo en vivo con precios actuales por token en api.tokspan.com/pricing. Consulte la documentación de Modelos para resúmenes por categoría y comparaciones de capacidades.

TokSpan cobra una pequeña tarifa de servicio transparente sobre la tarifa base de cada proveedor. Usted paga por los tokens que consume más un margen que cubre nuestra infraestructura, enrutamiento, red edge global y soporte.

El precio por token de cada modelo (tarifa de servicio incluida) es visible en tiempo real en el Model Hub antes de hacer una llamada. El precio que ve es el precio que paga — sin costos ocultos, sin facturas sorpresa.

No hay suscripción mensual ni compromiso mínimo. Recargue cualquier monto y comience a llamar modelos de inmediato.

Soportamos múltiples opciones de pago para clientes globales:

• Tarjetas de Crédito / Débito — Visa, Mastercard, American Express a través de Stripe. Se aplican tarifas estándar de procesamiento de tarjeta.
• PayPal — Disponible en más de 200 países y regiones.
• Transferencia Bancaria (Wire) — Disponible para cuentas empresariales (factura mínima: $500). Tiempo de procesamiento: 1–3 días hábiles.

Todos los pagos están denominados en USD. Su saldo se actualiza inmediatamente para pagos con tarjeta/PayPal; la transferencia aparece una vez confirmada.

Sí, con la siguiente política:

• Pagos con tarjeta de crédito / PayPal — Los créditos no utilizados son elegibles para reembolso dentro de los 7 días posteriores a la compra. La tarifa de servicio de la plataforma (el margen que agregamos sobre las tarifas del proveedor) no es reembolsable por los tokens ya consumidos.
• Transferencias bancarias — Los reembolsos se procesan en un plazo de 5–10 días hábiles, menos cualquier tarifa de transferencia.

Para solicitar un reembolso, contacte a support@tokspan.com con el correo de su cuenta y los detalles del pago.

Sí. Los créditos no utilizados expiran después de 12 meses de la compra. Esta política nos permite gestionar la responsabilidad del lado del proveedor manteniendo nuestra tarifa de servicio lo más baja posible. Recibirá recordatorios por correo electrónico 30 días y 7 días antes de que expire cualquier crédito. Las fechas de vencimiento son visibles en el Panel bajo Facturación → Créditos.

La recarga automática asegura que su saldo nunca llegue a cero:

1. Vaya a Panel → Facturación → Recarga Automática
2. Establezca un umbral (ej., $5 — cuando su saldo caiga por debajo de esto, activamos una recarga)
3. Establezca un monto (ej., $20 — cuánto agregar cada vez)
4. Elija su método de pago

Recibirá un recibo por correo electrónico por cada recarga automática. Puede deshabilitarla o ajustarla en cualquier momento. Recomendamos habilitarla para cargas de trabajo en producción para evitar interrupciones 402.

Tiene varios niveles de control de costos:

• Presupuesto mensual por clave — Establezca un límite de gasto estricto por clave API. Cuando la clave alcanza su límite, las solicitudes se rechazan hasta que aumente el límite o se reinicie el ciclo.
• Límites de tasa por modelo — Configure límites personalizados de RPM (solicitudes por minuto) y TPM (tokens por minuto) para cada clave API.
• Lista blanca de modelos — Restrinja una clave solo a modelos específicos (ej., solo permita modelos económicos para claves de desarrollo).
• Lista blanca de IP — Limite el uso de la clave a direcciones IP o rangos específicos.
• Panel de uso en tiempo real — Monitoree el gasto por clave, modelo y período de tiempo en el Panel.

Todos los límites se configuran desde Panel → API Keys al crear o editar una clave. Consulte Alcance de Claves para más detalles.

Los tokens se cuentan exactamente como los cuenta el proveedor upstream: tokens de prompt + tokens de completion = total de tokens facturables. Transmitimos el tokenizador de cada proveedor para que los conteos coincidan con lo que vería al llamar al proveedor directamente.

Para entradas multimodales (imágenes, audio, video): cada proveedor tiene su propia fórmula para convertir medios a equivalentes de tokens. Transmitimos el cálculo del proveedor — su panel muestra el conteo final de tokens y el costo. Generalmente: las imágenes en alta resolución son ~85–170 tokens cada una (GPT-4o), el audio es ~50 tokens por segundo (Whisper).

Para modelos con prompt caching (Claude, GPT-4o), los tokens de prompt en caché se facturan a la tarifa de caché con descuento del proveedor. Su panel de uso desglosa el gasto de tokens regulares vs. en caché.

No — no almacenamos sus prompts ni completions. Sus datos pasan a través de nuestra infraestructura en tiempo real y no se persisten. Registramos solo metadatos de la solicitud (modelo, conteo de tokens, marca de tiempo, ID de clave API) para precisión de facturación y prevención de abusos. Esto es necesario para calcular su uso y proteger la plataforma.

Nunca usamos sus prompts o completions para entrenamiento de modelos, y nunca vendemos ni compartimos sus datos con terceros.

Si requiere cero visibilidad de datos (es decir, no desea que veamos ni siquiera los metadatos), TokSpan es completamente auto-hospedable — despliéguelo detrás de su firewall con total soberanía de datos. Consulte ¿Puedo auto-hospedar? más abajo.

Esto depende del proveedor y su configuración:

• OpenAI — No entrena con llamadas API (desde marzo de 2023). Los datos enviados a través de la API no se usan para entrenamiento de modelos por defecto.
• Anthropic — No entrena con datos de API. Los datos de la API de Claude no se usan para mejorar modelos a menos que usted lo acepte explícitamente.
• Google (Gemini) — No entrena con uso de API de pago. El uso del nivel gratuito puede estar sujeto a términos diferentes.
• Otros proveedores — Las políticas varían. Consulte los términos de cada proveedor. Recomendamos revisar la política de uso de datos del proveedor si esto es una preocupación.

Para máximo control, auto-hospede TokSpan y configure sus claves API de upstream con proveedores que tengan políticas claras de no entrenamiento. Usted mantiene control total sobre qué proveedores tocan sus datos.

Todas las claves API están cifradas en reposo (AES-256). Las claves se muestran solo una vez al crearlas: no podemos recuperar una clave perdida (genere una nueva y revoque la anterior). Todo el tráfico API se cifra con TLS 1.3 en tránsito. Recomendamos usar claves API con lista blanca de IP, alcance por modelo y límites de gasto mensual para una defensa en profundidad. Rote las claves cada 90 días como práctica recomendada de seguridad.

La seguridad es fundamental para TokSpan. Nuestra infraestructura está construida alrededor de estos controles:

• TLS 1.3 — todos los datos en tránsito están cifrados de extremo a extremo.
• AES-256 — las claves API y credenciales están cifradas en reposo.
• MFA — autenticación multifactor compatible en todas las cuentas.
• Prácticas alineadas con GDPR — minimización de datos y divulgaciones de privacidad descritas en nuestra Política de Privacidad.

Los clientes empresariales pueden solicitar detalles adicionales sobre nuestra postura de seguridad en support@tokspan.com.

Sí. Nuestro servicio alojado implementa los requisitos de GDPR y CCPA: minimización de datos (no almacenamos sus prompts/completions), limitación de finalidad (los metadatos solo se usan para facturación y prevención de abusos), eliminación de datos del usuario a solicitud y divulgaciones transparentes sobre el procesamiento de datos.

Para requisitos estrictos de residencia de datos y cumplimiento, el auto-alojamiento le da control total: despliegue TokSpan en su propia infraestructura en cualquier región, detrás de su firewall. Contacte a support@tokspan.com para obtener un DPA (Acuerdo de Procesamiento de Datos).

Puede eliminar su cuenta y todos los datos asociados desde Panel → Configuración → Cuenta → Eliminar cuenta. La eliminación de la cuenta es permanente e irreversible.

Con respecto a su saldo:

• Cualquier crédito restante al momento de la eliminación se pierde. Recomendamos usar su saldo o solicitar un reembolso antes de iniciar la eliminación.
• Los registros de facturación requeridos por ley (recibos de pago, facturas) se conservan durante el período legal establecido, generalmente 7 años.
• Todos los demás datos de la cuenta (claves API, registros de uso, correo electrónico, configuración) se eliminan permanentemente en un plazo de 30 días.

Sí. Los DPA están disponibles para cuentas empresariales y de equipo. Proporcionamos un DPA estándar que cubre las obligaciones del procesador de datos según GDPR, divulgación de subprocesadores, salvaguardas para transferencias transfronterizas (SCC) y compromisos de notificación de brechas de seguridad. Contacte a support@tokspan.com con los requisitos de su equipo legal; el tiempo de respuesta habitual es de 2 a 3 días hábiles.

Sí, 100%. Cambie base_url a https://api.tokspan.com/v1 y su código existente del SDK de OpenAI funciona de inmediato: Python, Node.js, Go, curl o cualquier biblioteca compatible con OpenAI.

Funciones compatibles:

• Chat Completions — Soporte completo, incluyendo mensajes de sistema/usuario/asistente
• Streaming — SSE (Server-Sent Events) con stream: true
• Function / Tool Calling — Llamadas a herramientas en paralelo, modo estricto
• Modo JSON — Salida estructurada con response_format
• Visión / Entrada de imágenes — Imágenes por URL y base64
• Embeddings — Soporte completo en múltiples proveedores
• Audio — TTS (texto a voz) y STT (voz a texto / Whisper)
• Imágenes — Generación mediante DALL·E y modelos compatibles
• Rerank — Soporte completo
• Esfuerzo de razonamiento — Controle la profundidad de razonamiento mediante sufijos de modelo (ver más abajo)

Agregue un sufijo al nombre del modelo para controlar la profundidad de razonamiento:

Si no se proporciona un sufijo, se usa el nivel de razonamiento predeterminado del modelo. Esto le permite equilibrar velocidad y costo frente a la calidad de respuesta por solicitud, sin modificar su código de integración. Consulte Modelos → Esfuerzo de razonamiento para más detalles.

Además de los sufijos de razonamiento, TokSpan ofrece variantes orientadas al enrutamiento que controlan cómo se despacha su solicitud:

Combine sufijos cuando sea compatible: por ejemplo, gpt-5-high-fast para máximo razonamiento con enrutamiento de menor latencia. Consulte la documentación de Modelos para conocer la compatibilidad de sufijos por modelo.

Sí. El almacenamiento en caché de prompts se aplica automáticamente cuando el proveedor upstream lo admite (Claude, GPT-4o, Gemini). Cuando envía el mismo prefijo de prompt en múltiples solicitudes, el proveedor almacena en caché el cálculo y le cobra una tarifa con descuento por la parte almacenada, generalmente 90% de descuento sobre el precio completo del token de prompt.

No necesita modificar su código. TokSpan transmite el estado de caché del proveedor, y su panel muestra el uso de tokens en caché frente a los no almacenados. Para maximizar los aciertos de caché:

• Coloque el contenido estático (prompts de sistema, documentos de contexto) al inicio de su prompt
• Coloque el contenido dinámico (mensajes de usuario, consultas recientes) al final
• Reutilice el mismo prompt de sistema en todas las solicitudes

Lea la guía completa de optimización: Prompt Caching.

Sí. TokSpan admite Bring Your Own Key: puede agregar sus propias claves API de OpenAI, Anthropic, Google u otros proveedores en el Panel. Al configurar BYOK:

• Las solicitudes para ese proveedor se enrutan a través de su clave, no del pool de TokSpan
• Usted paga directamente al proveedor: TokSpan no cobra tarifa de servicio en solicitudes BYOK
• Puede seguir usando el endpoint unificado, failover y seguimiento de costos de TokSpan
• Combine claves BYOK con el pool de TokSpan: use sus claves para su proveedor principal y recurra a nuestro pool para los demás

BYOK es ideal para equipos con relaciones existentes con proveedores, descuentos empresariales o requisitos estrictos de separación de facturación. Configúrelo desde Panel → Configuración → Claves de proveedor.

TokSpan devuelve códigos de estado HTTP estándar:

Recomendamos implementar backoff exponencial con jitter para errores 429 y 5xx. Consulte Códigos de error para la referencia completa con los cuerpos de respuesta de error.

Apuntamos a un 99.99% de tiempo de actividad para nuestra API alojada. Nuestra infraestructura está escalada horizontalmente en múltiples zonas de disponibilidad, sin punto único de fallo. Para cargas de trabajo de misión crítica, las implementaciones auto-alojadas le dan control total sobre sus objetivos de disponibilidad.

Los planes empresariales incluyen un SLA formal con compromisos de tiempo de actividad, penalizaciones por crédito y respuesta prioritaria a incidentes. Contacte a support@tokspan.com para conocer los términos del SLA.

TokSpan realiza failover automáticamente a su siguiente modelo preferido. Nuestro sistema:

1. Detecta la indisponibilidad del proveedor (errores 5xx, tiempos de espera) en segundos
2. Omite proveedores con interrupciones recientes (ventana de espera de 30 segundos)
3. Enruta a su siguiente modelo en la cadena de failover (configurable en Panel → Canales)

Una cadena bien diseñada (por ejemplo, GPT-4o → Claude Opus → Gemini Pro) garantiza cero solicitudes perdidas. Solo paga por el modelo que finalmente atiende la solicitud; los intentos fallidos no se facturan. Consulte Failover automático para instrucciones de configuración.

TokSpan agrega una sobrecarga de enrutamiento mínima, generalmente menos de 100 ms para solicitudes API. El factor de latencia dominante es la velocidad de generación del modelo upstream (tiempo hasta el primer token y tokens por segundo), que no se ve afectada por el enrutamiento a través de TokSpan.

Para aplicaciones sensibles a la latencia:

• Active streaming (stream: true) para que los usuarios vean los tokens a medida que se generan
• Use el sufijo de modelo -fast para enrutar automáticamente al proveedor de menor latencia
• Despliegue una instancia auto-alojada en la región de su aplicación para eliminar la sobrecarga de red

Sí. Consulte la Página de estado de la API para conocer el estado del servicio en tiempo real, el historial de incidentes y las ventanas de mantenimiento programadas. Suscríbase a notificaciones de incidentes por correo electrónico, Slack o webhook; consulte Webhooks para la configuración.

Inicie sesión en el Panel, vaya a Claves API y haga clic en + Nueva clave. Asigne a cada clave un nombre descriptivo (por ejemplo, "producción-backend", "app-movil-dev", "staging-pruebas"). Puede crear claves ilimitadas.

Recomendamos encarecidamente crear claves separadas para cada entorno (desarrollo, staging, producción). Cada clave tiene seguimiento de uso, límites de gasto y alcance por modelo independientes, lo que facilita el monitoreo de costos por entorno o por cliente. Si una clave de desarrollo se ve comprometida, su clave de producción no se ve afectada.

Revóquela de inmediato desde el Panel: la revocación surte efecto al instante (propagación en menos de 60 segundos). Genere una nueva clave y actualice su aplicación. Monitoree los registros de uso para detectar cualquier actividad sospechosa en la clave anterior antes de eliminarla.

Prácticas recomendadas de prevención:

• Use lista blanca de IP para restringir desde dónde se pueden usar las claves
• Establezca límites de gasto mensual para limitar el radio de afectación si una clave se filtra
• Rote las claves cada 90 días
• Nunca incluya claves en el control de versiones: use variables de entorno o un gestor de secretos

Cree una clave API separada para cada entorno desde el Panel:

• Desarrollo — Límite de gasto bajo ($10/mes), restringido a modelos económicos, sin restricción de IP (para desarrollo local)
• Staging — Límite moderado ($50/mes), mismos modelos que producción, restringido por IP a sus servidores de staging
• Producción — Límite más alto según necesidad, todos los modelos, restringido por IP a sus servidores de producción

Cada clave tiene su propio panel de uso, alertas y registro de actividad. Esta configuración le brinda visibilidad de costos por entorno y evita que un error en fase de desarrollo consuma su presupuesto de producción. Consulte Alcance de claves para la referencia completa de configuración.

Sí. TokSpan puede desplegarse en su propia infraestructura mediante Docker, Docker Compose o Kubernetes. El auto-alojamiento le brinda:

• Soberanía total de datos: ningún dato sale de su infraestructura
• Control total de registros: usted decide qué se registra y dónde se almacena
• Cero sobrecarga de latencia: despliegue en la región de su aplicación
• Personalización ilimitada: adapte la plataforma según sus necesidades

Consulte nuestras guías de implementación o contacte a support@tokspan.com para recibir asistencia.

Sí. TokSpan admite implementaciones para equipos y empresas con controles de gestión dedicados:

• Espacios de trabajo de equipo — subclaves, roles y límites de uso por clave
• Facturación consolidada — una factura para todos los modelos y equipos
• Límites de tasa personalizados — ajustados a su carga de trabajo

Contacte a support@tokspan.com para conocer las opciones de implementación dedicada.

Sí. Los planes empresariales incluyen:

• Gerente de cuenta dedicado — Punto de contacto único para todas las consultas
• Soporte prioritario — Tiempos de respuesta garantizados (generalmente menos de 2 horas para problemas críticos)
• SLA personalizado — Compromisos de tiempo de actividad con penalizaciones por crédito adaptados a sus necesidades
• Facturación consolidada — Términos Net-30/60, órdenes de compra, facturación multidivisa
• Límites de tasa personalizados — Límites de RPM/TPM ajustados a su carga de trabajo
• Asistencia en implementación — Revisión de arquitectura, personalización de charts de Helm, configuración on-premise

Contacte a support@tokspan.com con sus requisitos; prepararemos una propuesta en un plazo de 1 día hábil.

Nuestra infraestructura alojada actualmente procesa datos en ubicaciones de borde globales para una latencia óptima. Para requisitos estrictos de residencia de datos (por ejemplo, datos sujetos a GDPR que deben permanecer en la UE, o regulaciones nacionales específicas), TokSpan es totalmente auto-alojable: despliéguelo en sus propios servidores en cualquier región, detrás de su firewall, con soberanía total de datos.

Los clientes empresariales también pueden conversar sobre implementaciones en regiones dedicadas gestionadas por nuestro equipo. Contacte a support@tokspan.com para conocer la disponibilidad en su región de interés.

Ofrecemos múltiples canales de soporte:

• Correo electrónico — support@tokspan.com para consultas de facturación, cuenta y temas técnicos. Respondemos en un plazo de 24 horas; la mayoría de las consultas se resuelven en un solo intercambio.
• Página de estado — Estado de la API para actualizaciones de incidentes en tiempo real. Suscríbase para recibir notificaciones durante interrupciones.

Los clientes empresariales reciben un canal de Slack compartido con nuestro equipo de ingeniería para colaboración en tiempo real.