Claude API: crea una API Key y prueba tu primera solicitud

1. Crea tu API Key de BetterToken

1. Inicia sesión en BetterToken Workspace.
2. Crea una API Key nueva para el grupo de claves compatible con Claude que indica la documentación.
3. Copia la clave una vez y guárdala en un gestor de secretos o en un archivo de entorno local excluido de Git.
4. Abre la documentación actual de la API y la página de precios para confirmar el Model ID vigente y su disponibilidad.

No pegues la clave en el código fuente, un prompt, una captura de pantalla, un mensaje de soporte ni un repositorio público. Los usuarios de BetterToken trabajan con sus propias cuentas y claves; el servicio no emite claves de Anthropic Console ni vende acceso a una cuenta compartida de Claude.ai.

2. Usa el endpoint compatible con Anthropic

Para el SDK de Anthropic o Claude Code, la Base URL de BetterToken es:

https://bettertoken.ai/

No añadas /v1 a esa Base URL. En una solicitud HTTP directa a Messages, la ruta completa del recurso es distinta:

POST https://www.bettertoken.ai/v1/messages

La diferencia es importante: los SDK añaden la ruta del recurso, mientras que un comando curl directo necesita la URL completa. Las herramientas compatibles con OpenAI utilizan otra Base URL y deben seguir su propia guía de configuración.

3. Envía la primera solicitud

Guarda la clave de BetterToken en una variable de entorno local. El nombre de la variable sigue la convención del SDK de Anthropic, pero su valor sigue siendo tu API Key de BetterToken.

export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="YOUR_MODEL_ID"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"Return only the word pong.\"}]
  }"

Sustituye los dos marcadores de posición únicamente en tu shell local. Utiliza un Model ID actual y exacto de los Docs de BetterToken o de la página de precios; los nombres y la disponibilidad de los modelos pueden cambiar.

4. Verifica la respuesta y el registro de uso

Una solicitud correcta devuelve HTTP 200 y un objeto de mensaje JSON. Comprueba que:

• type sea message;
• content contenga la respuesta del modelo;
• usage incluya el recuento de tokens de entrada y salida.

La referencia oficial de Anthropic Messages define la estructura del protocolo. Esta referencia no convierte una clave emitida por BetterToken en una clave de Anthropic; solo documenta el formato compatible de solicitud y respuesta.

A continuación, abre BetterToken Workspace y localiza la solicitud por la hora. Confirma el modelo, el estado, los tokens de entrada, salida y caché cuando corresponda, y el coste asociado. Workspace contiene metadatos de uso y registros de facturación; no presupongas que almacena el prompt o la respuesta completos.

5. Corrige errores habituales de la primera solicitud

• 404 o ruta incorrecta: una solicitud HTTP directa utiliza /v1/messages; /messages por sí sola está incompleta.
• 400: revisa anthropic-version, content-type, el Model ID, max_tokens y el array messages.
• 401 o 403: comprueba la clave de BetterToken, el grupo de claves, la Base URL y posibles espacios accidentales. No envíes la clave al soporte.
• 429: lee el cuerpo de la respuesta, respeta la espera indicada y revisa las solicitudes concurrentes y los límites actuales antes de reintentar.
• No aparece ningún registro en Workspace: verifica que la solicitud utilizó la Base URL de BetterToken y no otro proveedor que permaneciera configurado en el entorno.

Si quedan valores de otro proveedor en el shell, elimínalos antes de volver a empezar:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL
unset CLAUDE_MODEL_ID

Vuelve a definir los tres valores con la información actual de configuración de BetterToken y envía una sola solicitud, no un bucle de reintentos.

Siguiente paso

Cuando la solicitud mínima funcione, traslada la clave al almacén de secretos de tu aplicación, configura un timeout finito y añade reintentos limitados solo para fallos temporales. Revisa los Docs actuales de BetterToken y mantén Workspace abierto mientras pruebas la primera integración real.