URL base, interfaces y autenticación

URL base de 1折AI, interfaces disponibles, cómo escribir las cabeceras de solicitud y cuándo añadir /v1 en distintas herramientas.

Todas las solicitudes se envían al mismo dominio, con dos conjuntos de rutas según el protocolo.

1
https://1zheai.com

Interfaces disponibles

Interfaz	Protocolo	Uso
`POST /v1/messages`	Nativo de Anthropic	Conversación. Claude Code, Anthropic SDK y Cline (modo Anthropic) usan esta
`POST /v1/chat/completions`	Compatible con OpenAI	Conversación. OpenAI SDK, Cursor y Cherry Studio (modo OpenAI) usan esta
`GET /v1/models`	Compatible con OpenAI	Lista los modelos que puede usar tu clave API (API key)
`POST /v1/messages/count_tokens`	Nativo de Anthropic	Calcula el número de tokens de una entrada; no genera conversación ni cobra

El cuerpo de la solicitud de count_tokens es igual que el de /v1/messages (model, messages, y puede incluir system y tools); la respuesta solo tiene un campo:

1
{"input_tokens":19}

count_tokens solo cuenta lo que envías. Cuando se llama realmente mediante un SDK, curl o una herramienta de terceros, cada solicitud incluye además un mensaje de sistema que se factura según los tokens de entrada (Claude Code no lo incluye); consultael facturación del mensaje de sistema.

Capacidades propias de Claude como Prompt Caching, extended thinking o las llamadas a herramientas funcionan de forma más fiable con el /v1/messages nativo. La interfaz compatible con OpenAI es adecuada para escenarios en los que ya tienes código de OpenAI y solo quieres cambiar de modelo.

Si hay que añadir /v1

Diferentes herramientas interpretan la URL base de forma distinta; este es el error más común al conectar:

Herramienta / SDK	Qué rellenar	Motivo
Claude Code (`ANTHROPIC_BASE_URL`)	`https://1zheai.com`	La herramienta añade por sí misma `/v1/messages`
Anthropic SDK (`base_url`)	`https://1zheai.com`	Igual que arriba
OpenAI SDK (`base_url`)	`https://1zheai.com/v1`	El SDK solo añade `/chat/completions`
Cursor (Override OpenAI Base URL)	`https://1zheai.com/v1`	Igual que OpenAI SDK
Cherry Studio	`https://1zheai.com`	Añade automáticamente `/v1/...`
Cline (OpenAI Compatible)	`https://1zheai.com/v1`	Igual que OpenAI SDK

Regla: en la familia Anthropic se rellena la dirección raíz; en la familia OpenAI se rellena hasta /v1. El síntoma típico de rellenarlo mal es un 404.

Cabeceras de autenticación

La clave API se coloca en la cabecera de la solicitud; se pueden usar ambas formas:

Anthropic 原生
Bearer（两种协议都支持）

x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json

Authorization: Bearer sk-你的Key
content-type: application/json

Al llamar a /v1/messages, incluye anthropic-version según el protocolo oficial; el valor actual es 2023-06-01. En pruebas funciona sin él, pero el SDK y las herramientas oficiales lo incluyen, así que inclúyelo también cuando escribas las solicitudes a mano.
El ANTHROPIC_AUTH_TOKEN de Claude Code envía Authorization: Bearer, y el ANTHROPIC_API_KEY envía x-api-key; aceptamos ambos.
Cuando necesites funciones beta, incluye la cabecera anthropic-beta según la documentación oficial. Incluir un valor no reconocido no provoca error, así que si una función beta está activa o no, se determina por el efecto real en la respuesta.

Comprobar si la clave API está disponible

1
curl https://1zheai.com/v1/models \
2
  -H "Authorization: Bearer sk-你的Key"

Si devuelve la lista de modelos, la clave API y la dirección son correctas. Si devuelve 401, el problema es la clave API; la respuesta tiene esta forma (probado el 2026-10-15):

1
{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}

Al solicitar /v1/models con las cabeceras x-api-key y anthropic-version, se devuelve la lista de modelos en formato Anthropic (data[].id, display_name, has_more); el descubrimiento automático de modelos de Claude Code lee este formato.

Para otros casos, consultacódigos de error y solución de problemas.

Límites de velocidad

Actualmente no se aplican límites de velocidad a las claves API. Si recibes un 429, normalmente es por alta carga del proveedor upstream; reintenta más tarde y añade retroceso exponencial en tareas por lotes. Consultacódigos de error y solución de problemas.

Red

Si hay timeout de conexión o errores de TLS, comprueba primero la red que usa el terminal: si tienes un proxy global activo, desactívalo y conecta directamente para probar de nuevo; si la red corporativa tiene una lista blanca de salidas, es necesario permitir 1zheai.com.