SDK
Usa los SDK oficiales de OpenAI, Anthropic y Google Gen AI con Half Off Dev a mitad del precio oficial ajustando dos opciones del cliente.
Como Half Off Dev habla la API de cada proveedor del modelo en su propio formato, no necesitas ninguna librería especial. Instala el SDK oficial, pasa al constructor del cliente la URL base de Half Off Dev y tu clave, y a partir de ahí sigue la documentación oficial. Primero crea una clave de API.
Tip
En Usar en herramientas dentro de API keys, la pestaña cURL / SDK tiene estos ejemplos con tu clave ya puesta.
SDK de Anthropic#
URL base https://halfoff.dev, sin /v1: el SDK añade la versión.
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://halfoff.dev",
api_key=os.environ["HALFOFF_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5.5",
max_tokens=1024,
messages=[{"role": "user", "content": "Sugiere un nombre para una CLI que renombra archivos."}],
)
print(message.content[0].text)SDK de OpenAI#
URL base https://halfoff.dev/v1.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://halfoff.dev/v1",
api_key=os.environ["HALFOFF_API_KEY"],
)
completion = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Escribe una regex que valide fechas ISO."}],
)
print(completion.choices[0].message.content)Chat Completions acepta todos los modelos de texto, así que este mismo cliente puede llamar a claude-sonnet-5.5 o gemini-3.1-pro con solo cambiar model.
SDK Google Gen AI#
URL base https://halfoff.dev, pasada en las opciones HTTP.
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["HALFOFF_API_KEY"],
http_options=types.HttpOptions(base_url="https://halfoff.dev"),
)
response = client.models.generate_content(
model="gemini-3.1-pro",
contents="Resume el teorema CAP en un párrafo.",
)
print(response.text)Detalles de cada formato: Anthropic Messages, OpenAI Chat Completions, Gemini.
Solución de errores#
| Lo que ves | Qué hacer |
|---|---|
401 Missing API key | El cliente no envió clave. Comprueba que HALFOFF_API_KEY esté definida donde se ejecuta tu código. |
401 Invalid or revoked API key | La clave está mal escrita, cortada o revocada. Pégala de nuevo o crea otra. |
404 Model '...' is not available | Ese id no existe. Copia uno de GET /v1/models o de la lista de modelos. |
404 con /v1/v1/ en la ruta | Le pasaste https://halfoff.dev/v1 al SDK de Anthropic. Él añade /v1, así que pásale https://halfoff.dev; solo el SDK de OpenAI usa la forma con /v1. |
402 | El saldo está a cero o la clave alcanzó su tope de gasto. Mira Saldo y facturación. |
Cualquier otro código se explica en Errores.