Autenticación

Cada petición a Helmcode se autentica con una API key Bearer enviada contra la base URL. La API es compatible con OpenAI — cualquier SDK de OpenAI se encarga de esto por ti.

Base URL

https://api.helmcode.com/v1

API keys

Las API keys se emiten por workspace desde el panel → API Keys. Pertenecen a tu organización — no a ti personalmente — y se pueden crear o revocar en cualquier momento. El número de keys disponibles depende de tu plan — 5 en Starter, 15 en Growth, 40 en Scale.

Trata las keys como contraseñas: guárdalas en el servidor como variables de entorno, nunca las subas al control de versiones, nunca las incluyas en código del lado del cliente.

Cabecera de autorización

Envía tu key en la cabecera Authorization en cada petición:

Authorization: Bearer sk-your-key-here

Ejemplos

cURL

curl https://api.helmcode.com/v1/models \
  -H "Authorization: Bearer $HELMCODE_API_KEY"

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.helmcode.com/v1",
    api_key=os.environ["HELMCODE_API_KEY"],
)

Errores

Una key ausente o inválida devuelve 401 Unauthorized. Para 429 Too Many Requests, consulta Rate limits.

Aviso: un id de modelo que tu key no alcanza devuelve el mismo 401, con el mensaje This API key does not have access to the requested model. Una errata es indistinguible de un problema de permisos: glm-5.3 falla y glm5.3 funciona, y el error del primero se lee como si a tu plan le faltara algo. Antes de dar por hecho que es acceso, compara el id con Modelos carácter a carácter.