---
title: "URL base, interfaces y autenticación"
description: "URL base de 1折AI, interfaces disponibles, cómo escribir las cabeceras de solicitud y cuándo añadir /v1 en distintas herramientas."
headingIds: {"Interfaces disponibles":"section-1","Si hay que añadir /v1":"section-2","Cabeceras de autenticación":"section-3","Comprobar si la clave API está disponible":"section-4","Límites de velocidad":"section-5","Red":"section-6"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

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

```text
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:

```json
{"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); consulta[el facturación del mensaje de sistema](/es/docs/pricing-explained/#section-3).

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:

<CodeGroup>
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="Bearer（两种协议都支持）"
Authorization: Bearer sk-你的Key
content-type: application/json
```
</CodeGroup>

- 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

```bash
curl https://1zheai.com/v1/models \
  -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):

```json
{"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, consulta[códigos de error y solución de problemas](/es/docs/troubleshooting/).

## 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. Consulta[códigos de error y solución de problemas](/es/docs/troubleshooting/).

## 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`.