Inicio rápido
1. Regístrate en console.quantoport.com y crea una clave de API (sk-tp-…).
2. Apunta tu herramienta a la base URL de abajo.
3. Envía tu primera petición.
| Tu herramienta habla… | Base URL | Llamada de ejemplo |
|---|---|---|
| OpenAI SDK / Chat | https://quantoport.com/v1 | POST /v1/chat/completions |
| Anthropic SDK / Messages | https://quantoport.com | POST /v1/messages |
| Responses (Codex) | https://quantoport.com/v1 | POST /v1/responses |
Pruébalo con curl (chat compatible con OpenAI):
curl https://quantoport.com/v1/chat/completions \
-H "Authorization: Bearer $QUANTOPORT_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Say hello in one line"}]}'
Consejo: consulta tu lista de modelos en vivo en cualquier momento con GET /v1/models con la misma clave — el catálogo siempre está actualizado y es por clave.
Protocolos y endpoints
Los tres formatos comparten una clave y un saldo. Los cuerpos de petición y las respuestas son compatibles byte a byte con las API de origen — apunta cualquier SDK oficial a la base URL correspondiente.
- Chat Completions — mensajes en formato OpenAI, llamada a funciones y streaming por SSE. Úsalo con los SDK de OpenAI, Cherry Studio y la mayoría de herramientas.
- Anthropic Messages — x-api-key cabecera + anthropic-version. Úsalo con Claude Code y el SDK de Anthropic.
- Responses — el protocolo moderno de agentes de OpenAI que usa Codex CLI y su extensión.
Si un cliente de terceros añade rutas de forma extraña, añade o quita /v1 en la base URL — la pasarela acepta ambas formas y normaliza internamente.
Generación de vídeo
HappyHorse 1.1 genera vídeo a partir de texto, una imagen o un clip de referencia. Usa la misma clave de API y el mismo saldo que tus modelos de chat.
- Interfaz web： abre /video, pega tu clave, describe el plano y genera.
- API: POST /v1/videos con {model, prompt, resolution, seconds, image_url} y la cabecera Authorization: Bearer <clave> (base https://console.quantoport.com) → devuelve un id; consulta GET /v1/videos/{id} hasta status = completed y descarga el archivo desde GET /v1/videos/{id}/content.
- Modelos: happyhorse-1.1-t2v (texto), happyhorse-1.1-i2v (imagen), happyhorse-1.1-r2v (referencia).
- Precios: 480P/720P $0.35 por clip de 5 segundos (10s = ×2). Se cobra al aceptar el trabajo; los fallidos se reembolsan.
- Resolución pasa siempre resolution de forma explícita (480P / 720P / 1080P). Si falta o está mal escrito, el upstream genera en 1080P y cobra la tarifa de 1080P.
- Notas: la generación suele tardar 1–3 minutos; los enlaces de salida son temporales, descarga cuanto antes.
Configuración de herramientas
export ANTHROPIC_AUTH_TOKEN=$QUANTOPORT_KEY
claude
codex --config set model gpt-6-astra
# base_url https://quantoport.com/v1 · responses
provider = "openai"
base_url = "https://quantoport.com/v1"
api_key = "sk-tp-…"
model = "glm-5.3" # any model we serve
Facturación y tokens
- Los créditos no caducan. Recarga con USDT en TRC-20 / BSC / Solana (mín. $10): copia la dirección en la Planes página, haz la transferencia y pega tu TXID de vuelta en esa página — el saldo se acredita automáticamente, normalmente en un minuto.
- La medición por petición cubre tokens de entrada, salida, escritura de caché, lectura de caché y razonamiento. El streaming cuesta igual que sin streaming.
- Precios publicados: Claude y GPT al 25% de descuento; DeepSeek 12% de descuento y Kimi K3; GLM-5.3 20% de descuento, GLM-5.2 30% de descuento; Qwen. Los descuentos son una política permanente, no una promoción.
- Tu saldo y el uso por clave se ven en la consola; consulta el saldo desde el servidor con GET /v1/balance.
Visión
qwen3-vl-plus entiende imágenes: describe capturas, lee documentos, hace OCR o analiza fotos. Usa la misma clave de API y saldo que tus modelos de chat.
- Formato de llamada (compatible con OpenAI):
POST /v1/chat/completions { "model": "qwen3-vl-plus", "messages": [{ "role": "user", "content": [ {"type": "text", "text": "Describe this image"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}} ] }] } - Precios: $0.2 / $1.6 por 1M de tokens. Las imágenes se facturan como tokens de imagen (aproximadamente 100–1200 tokens por imagen según el tamaño).
- Fuentes de imagen: usa una URL accesible públicamente o incrusta la imagen como data URL base64 (data:image/png;base64,...).
- Proxy de imágenes (recomendado para imágenes alojadas en el extranjero): nuestra región de inferencia está en China continental, por lo que los hosts de imágenes en el extranjero pueden agotar el tiempo. Envuelve cualquier URL externa con nuestro proxy y funciona en todas partes:
https://quantoport.com/img-proxy?u=<URL-encoded image url>
Ejemplo: https://quantoport.com/img-proxy?u=https%3A%2F%2Fpicsum.photos%2F400%2F300
El proxy obtiene la imagen una vez, la cachea y la sirve desde nuestro dominio — menos de un segundo en llamadas repetidas.
Errores y límites de velocidad
| Estado | Significado | Acción |
|---|---|---|
| 400 | Petición malformada / modelo desconocido para tu clave | Comprueba el ID del modelo en GET /v1/models |
| 401 | Clave ausente o no válida | Revisa la cabecera de la clave |
| 402 | Saldo insuficiente | Recarga (USDT) |
| 404 | Endpoint incorrecto para la familia de modelos | Usa la base URL correcta según la tabla de protocolos |
| 429 | Límite de velocidad por clave alcanzado | Espera o sube el límite de la clave en la consola |
| 5xx | Problema del proveedor de origen | Espera y reintenta; comprueba /healthz |
Las claves tienen por defecto un límite conservador de peticiones por minuto; súbelo o bájalo por clave en la consola. Durante caídas del origen la pasarela devuelve 5xx mientras GET /v1/models and /healthz siguen en verde — esa distinción significa que el problema es del origen, no de tu clave.