Inicio rápido

En esta página pasas de una cuenta vacía a una respuesta en streaming que ya aparece en tu registro de uso. El ejemplo usa el SDK de OpenAI porque casi todos los proyectos lo tienen instalado, pero la misma clave sirve con los SDK de Anthropic y Google.

1. 1

   Consigue una clave

   Crea una cuenta, entra en API keys y pulsa Nueva clave. La clave empieza por ho- y solo se muestra esta vez, así que cópiala antes de cerrar el diálogo.

   Guárdala en una variable de entorno para no dejarla en el código:

   Shell

   export HALFOFF_API_KEY="ho-..."

   También necesitas saldo. Recarga desde el panel con PayPal; los detalles están en Saldo y facturación.

2. 2

   Apunta tu cliente a Half Off Dev

   Cambia la dirección del cliente a https://halfoff.dev/v1 y pon tu clave. El resto de la llamada queda igual.

   cURLPythonNode.js

   Shell

   curl https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-6.1-sol",
       "messages": [{"role": "user", "content": "Explica qué es una condición de carrera en dos frases."}]
     }'

   ¿Prefieres los SDK nativos? Claude con el SDK de Anthropic está en Anthropic Messages y Gemini con el SDK de Google en Gemini.

3. 3

   Recibe los tokens a medida que se generan

   Pon stream en true y lee los fragmentos. El formato de eventos es exactamente el de la API oficial.

   cURLPythonNode.js

   Shell

   curl -N https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{"model": "gpt-6.1-sol", "stream": true,
          "messages": [{"role": "user", "content": "Enumera los planetas, uno por línea."}]}'

   Más detalles en Streaming.

4. 4

   Mira cuánto pagaste

   Abre Logs. Cada llamada aparece en segundos con sus tokens de entrada y salida, el importe cobrado, el tiempo hasta el primer token y los tokens por segundo. Cada respuesta lleva además la cabecera x-halfoff-request-id; inclúyela si escribes a soporte sobre esa llamada.

Cómo encontrar los ids de modelo#

GET /v1/models no necesita clave y devuelve todos los modelos con su ventana de contexto y su precio. La lista de modelos muestra los mismos datos.

curl https://halfoff.dev/v1/models

Los ids se reconocen con flexibilidad: claude-sonnet-5.5, claude-sonnet-5-5 y anthropic/claude-sonnet-5.5 llevan al mismo modelo.

Siguientes pasos#