Preguntas frecuentes

Respuestas cortas, cada una completa por sí sola. Para el valor exacto que debes enviar en model, usa la página Modelos; para el precio de hoy, la página de cada modelo en oceantoken.ai.

¿Qué es OceanToken?

OceanToken es una API y un saldo prepago para más de 500 modelos de IA: modelos de texto, imagen, video, voz, transcripción, embeddings y rerank de OpenAI, Anthropic, Google, DeepSeek, Qwen, ByteDance y unos 60 editores más. Creas una cuenta, agregas créditos, creas una clave de API y llamas a cualquier modelo con la misma URL base y la misma clave. El precio, la ventana de contexto y las capacidades de cada modelo aparecen en el catálogo antes de que lo llames.

¿OceanToken es compatible con OpenAI? ¿Qué SDK funcionan?

Sí. La API de OceanToken habla la API de OpenAI, así que los SDK oficiales de OpenAI para Python, TypeScript y otros lenguajes funcionan cambiando dos valores: la URL base a https://api.oceantoken.ai/v1 y la clave de API a tu clave de OceanToken. Todos los modelos de chat, entre ellos Claude, GPT, Gemini y DeepSeek, también responden a la API Messages de Anthropic en /v1/messages, así que el SDK de Anthropic funciona sin cambios con esas mismas dos modificaciones; recibe la URL base https://api.oceantoken.ai y agrega /v1 por su cuenta. Chat completions, la API Responses, imágenes, video, embeddings, voz, transcripción y rerank siguen los mismos formatos.

¿Qué modelos de IA puedo llamar con OceanToken?

El catálogo tiene más de 500 modelos de 7 tipos: modelos de lenguaje (GPT, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, Grok, Mistral, Llama y más), modelos de generación y edición de imágenes, modelos de generación de video, texto a voz, voz a texto, embeddings de texto y rerankers. La página Modelos lista cada uno con su ID exacto, su precio por unidad, su ventana de contexto y si admite razonamiento, llamadas a herramientas o entrada de imágenes. La lista se reconstruye a partir del servicio en vivo cada vez que se publica la documentación.

¿Cuánto cuesta OceanToken? ¿Hay una tarifa de plataforma?

Pagas por uso al precio indicado para cada modelo, en dólares estadounidenses, desde un saldo prepago; no hay suscripción. Los modelos se cobran por uso, sin tarifa de plataforma. Al recargar, en el pago se añade una comisión de procesamiento del 2,9 % + $0.30 sobre el total pagado, igual para todos los métodos de pago; no se suma a tu saldo. Por ejemplo, $100 de créditos cuestan $103.30. Los modelos de lenguaje se cobran por cada millón de tokens de entrada, de entrada en caché y de salida (y de escritura en caché, cuando el modelo la cobra); las imágenes, por imagen, por megapíxel o por token de imagen; el video, por segundo; la voz, por cada 1,000 caracteres; la transcripción, por minuto de audio; y el rerank de Cohere, por unidad de búsqueda. El precio de un modelo es el mismo a cualquier hora del día, y smart-router se cobra al precio del modelo que elige. Algunos modelos tienen la etiqueta :free y no cuestan nada, con un rendimiento limitado. La página de cada modelo en oceantoken.ai muestra su precio actual antes de que hagas una llamada.

¿Por qué no se guarda en caché mi prompt de Claude?

Claude guarda un prompt en caché solo cuando la solicitud lo pide. Marca el final de la parte repetida con "cache_control": {"type": "ephemeral"} en un bloque de contenido, en /v1/chat/completions o /v1/messages; a partir de la siguiente solicitud, esa parte se lee de la caché y se cobra al precio de entrada en caché del modelo. Los modelos GPT, DeepSeek, Qwen y GLM usan la caché por su cuenta. Un acierto aparece en usage: prompt_tokens_details.cached_tokens en chat completions y cache_read_input_tokens en /v1/messages. Claude solo guarda en caché un prefijo que supere una longitud mínima, de 512 a 4,096 tokens según el modelo. La referencia de la API tiene ejemplos de ambos formatos.

¿Cómo uso OceanToken con Claude Code, Codex, Cursor o Gemini CLI?

Ejecuta un comando en una terminal e inicia sesión: npx -y @oceantoken/cli@latest connect codex (o claude-code, cursor, gemini, openclaw). Agrega a ese agente el servidor MCP de OceanToken en https://mcp.oceantoken.ai/mcp y 3 skills, con los que puede buscar modelos, estimar costos y generar imágenes, video y voz con tu saldo. Un agente de IA también puede seguir por su cuenta las instrucciones de https://mcp.oceantoken.ai/install. La misma clave de API funciona en cualquier herramienta compatible con OpenAI configurando la URL base.

¿OceanToken genera imágenes, video y voz, no solo texto?

Sí. Los modelos de imagen responden en /v1/images/generations y /v1/images/edits; los de video, en /v1/videos como trabajos asíncronos que consultas; texto a voz, en /v1/audio/speech; la transcripción, en /v1/audio/transcriptions; los embeddings, en /v1/embeddings; y los rerankers, en /v1/rerank. Los 7 tipos usan la misma clave y el mismo saldo, y cada solicitud aparece en Registros de la consola con su costo y su latencia. Las URL de descarga de imágenes y videos son válidas durante 24 horas, y los trabajos de video aceptan un Idempotency-Key, así que un reintento nunca puede iniciar y cobrar un segundo trabajo.

¿Puedo limitar cuánto puede gastar una clave de API?

Sí. Cada clave de API puede tener su propio límite de créditos, con reinicio diario, semanal o mensual si quieres, y una fecha de vencimiento, para que una clave de un proyecto de prueba o de un compañero no pueda gastar del saldo compartido más de lo que permites; una clave que agotó su límite recibe un error 400 key_budget_exceeded aunque la cuenta todavía tenga créditos. La consola muestra el uso de cada clave, y la página Registros lista cada solicitud con su modelo, tokens, costo y latencia. Las claves se muestran una sola vez al crearlas y se pueden rotar con 24 horas de superposición.

¿Cómo funcionan la facturación y el saldo prepago?

Agregas créditos con tarjeta en la consola, eligiendo $5, $10, $25 o $50, o escribiendo tu propio monto. Al recargar, en el pago se añade una comisión de procesamiento del 2,9 % + $0.30 sobre el total pagado, igual para todos los métodos de pago; no se suma a tu saldo. Tu primera recarga además recibe un bono del 10 % del crédito que compra, hasta $100 (las reglas están en Bono de primera recarga: https://docs.oceantoken.ai/es/get-started/add-credits#first-top-up-bonus ). Cada solicitud descuenta su costo exacto de ese saldo prepago al precio que el modelo tiene en el momento de la llamada, nunca de forma retroactiva. Los créditos comprados son válidos durante 12 meses desde la compra (Términos del servicio, sección 6), y no hay mínimo mensual. Mientras el saldo sea de $0 o menos, se rechaza toda solicitud a un modelo de pago hasta que agregues créditos (los modelos cuyo ID termina en :free siguen funcionando); los trabajos largos, como el video, reservan su costo estimado hasta terminar. El gasto por día y por modelo aparece en la página Actividad.

¿OceanToken tiene un plan gratuito?

Los modelos cuyo ID termina en :free no cuestan nada, con un rendimiento limitado y no garantizado; los filtros de la página Modelos los muestran con la etiqueta Free. Funcionan incluso con un saldo de $0 y las llamadas no lo reducen, así que puedes probar el formato de la API, la configuración del SDK y la integración con agentes sin gastar, y luego pasar a un modelo de pago cambiando solo el ID del modelo.

¿Cuáles son los límites de velocidad y los tiempos de espera de OceanToken?

Los límites de velocidad son por clave de API, en solicitudes por minuto y tokens por minuto, y las respuestas incluyen los límites de la clave en los encabezados x-oceantoken-key-rpm-limit y x-oceantoken-key-tpm-limit; superar uno devuelve 429 rate_limited con un encabezado Retry-After. Una solicitud síncrona puede durar como máximo 240 segundos y su cuerpo puede pesar como máximo 10 MB, así que las generaciones de texto largas deben usar stream: true y los archivos grandes deben enviarse como URL. La generación de video se ejecuta como un trabajo que tarda minutos, así que consultas /v1/videos/{video_id} en lugar de mantener una conexión abierta. Los detalles están en la página Límites.

¿Qué pasa si un proveedor de modelos se cae?

Normalmente no notas nada. Muchos modelos, incluidos los modelos actuales de Claude y GPT, tienen más de un canal oficial o autorizado; cuando uno falla, está al límite de capacidad o deja de responder, OceanToken reintenta la solicitud y la pasa a otro canal del mismo modelo, al mismo precio. Nunca responde con otro modelo a menos que tú mismo indiques modelos de respaldo con el parámetro fallbacks, y un intento que falla antes de producir salida no se cobra. Los errores que cualquier canal devolvería, como una solicitud mal formada o un rechazo por seguridad, te llegan directamente, y un stream que se corta después de empezar la salida puede terminar con un error, así que mantén un reintento con espera progresiva para 429 y 5xx. La página Reintentos y conmutación por error tiene los detalles.