GLM-5.3
Llame a GLM-5.3 con la API de Chat Completions compatible con OpenAI.
| Elemento | Valor |
|---|---|
| Base URL | https://api.hop-base.com/v1 |
| Modelo | glm-5.3 |
| Chat | Solo POST /v1/chat/completions — /v1/responses y /v1/messages no se admiten y devuelven 400 |
Use una clave que incluya el grupo GLM oficial directo; las claves sin él reciben un 404.
Selección de grupo y facturación
GLM-5.3 es el modelo insignia más reciente de Zhipu: ventana de contexto de 1M con control de longitud de pensamiento, con acceso oficial directo.
glm-5.3se vende en el grupo GLM oficial directo, con una ventana de contexto de 1M. Al crear o editar una clave en Claves API de la consola, añada este grupo a la clave. Su tarifa efectiva se muestra en la Plaza de modelos tras iniciar sesión.- Las claves que no incluyen ninguno de los dos grupos reciben un 404 explícito al llamar a
glm-5.3: añada uno de estos grupos a la clave en la consola, o cree una clave nueva con él. - GLM-5.2 se ha retirado; los proyectos que llamaban a
glm-5.2solo tienen que cambiar el nombre del modelo aglm-5.3.
Parámetros de la solicitud
Para POST /v1/chat/completions. La pasarela solo rechaza messages vacío; el resto de límites son del servicio del modelo, con textos de error tomados de registros de producción.
| Parámetro | Obligatorio | Tipo y límites | Predeterminado | Descripción |
|---|---|---|---|---|
model | Obligatorio | glm-5.3 | — | Coincidencia exacta |
messages | Obligatorio | Array no vacío, solo texto | — | Ausente o vacío: 400 de la pasarela; con imágenes devuelve 400. Contexto de 1M |
max_tokens | Opcional | Entero 1–131.072 | Del servicio | Fuera del rango devuelve 400 max_tokens参数非法:限制数值范围[1,131072]; lo comparten razonamiento y respuesta |
reasoning_effort | Opcional | low / high / max | Nivel predeterminado del modelo | Siempre piensa: none u otro valor que lo desactive devuelve 400 |
temperature, top_p | Opcional | Se transmiten; sin rango en la pasarela | Del servicio | Controles de muestreo, se reenvían tal cual |
tools, tool_choice | Opcional | Como en OpenAI | auto | Un resultado tool devuelto debe corresponder a un ID de llamada del turno anterior; si no, 400 No tool call found for function call output |
stream | Opcional | Booleano | false | Con true responde con eventos SSE |
stream_options.include_usage | Opcional | Booleano | false | Debe ser true para recibir el fragmento usage en streaming |
El texto del 400 por desactivar el pensamiento varía según el grupo: gestiónelo por el código de estado y el valor de reasoning_effort, no por el mensaje.
Campos del cliente
| Campo | Valor |
|---|---|
| Dirección de la API / Base URL | https://api.hop-base.com/v1 |
| Clave API | sk-tu-clave |
| Modelo | glm-5.3 |
| Formato de la API (solo CC Switch y otros clientes con enrutamiento) | OpenAI Chat Completions (se requiere enrutamiento) |
El campo "Formato de la API" de arriba solo existe en CC Switch y clientes similares capaces de enrutar entre protocolos — no es un parámetro que se envíe en el cuerpo de la solicitud. En Claude Code, CC Switch y otros clientes que admiten enrutamiento, GLM-5.3 no usa el protocolo Anthropic. En la configuración avanzada, seleccione OpenAI Chat Completions (se requiere enrutamiento). Una llamada directa con el SDK de OpenAI o curl nunca toca este ajuste; vaya directamente a las secciones siguientes.
Usar GLM-5.3 en Claude Code con CC Switch
Use CC Switch 3.17.0 o posterior. GLM-5.3 usa OpenAI Chat Completions, por lo que CC Switch debe traducir las solicitudes mediante su enrutador local al protocolo Anthropic Messages que usa Claude Code.
Agregar un proveedor HopBase GLM
Abra CC Switch, seleccione la pestaña Claude Code, seleccione + en la esquina superior derecha y luego elija Configuración personalizada. Ingrese:
- Nombre del proveedor:
HopBase GLM - API Key: su clave
sk- - Dirección de solicitud:
https://api.hop-base.com/v1
Configurar el formato de la API y el mapeo de modelos
Expanda Opciones avanzadas, aplique estos ajustes y luego guarde:
- Formato de la API: OpenAI Chat Completions (se requiere enrutamiento)
- Campo de autenticación: mantenga el valor predeterminado ANTHROPIC_AUTH_TOKEN
- Modelo de respaldo predeterminado:
glm-5.3
Para forzar que los roles Sonnet, Opus y Haiku usen GLM-5.3, también mapee los tres roles a glm-5.3. Después de guardar, la tarjeta del proveedor mostrará Se requiere enrutamiento.
Habilitar el enrutamiento local
Abra Configuración → Enrutamiento → Enrutamiento local. Active el interruptor principal de enrutamiento y luego active Claude Code en el enrutamiento por aplicación. Confirme el mensaje de primer uso y deje CC Switch en ejecución en segundo plano.
Enable y verificar el proveedor
Vuelva a la lista de proveedores de Claude Code y seleccione Enable en la tarjeta HopBase GLM. Después de habilitar la toma de control del enrutamiento por primera vez, cierre y vuelva a abrir la terminal, ejecute claude y envíe un prompt breve.
Vuelva a Configuración → Enrutamiento. La configuración funciona cuando Current Provider muestra HopBase GLM y el conteo de solicitudes aumenta. Una vez que el enrutamiento está activo, los cambios de proveedor posteriores se aplican en caliente sin otro reinicio de la terminal.
Codex CLI
En el grupo GLM oficial directo, glm-5.3 y glm-5.3-flash solo ofrecen OpenAI Chat Completions: /v1/responses devuelve 400 endpoint_not_supported. Codex CLI solo habla Responses desde la 0.122 (se eliminó wire_api = "chat"), así que Codex CLI no puede conectarse a GLM-5.3. En Codex CLI, use GPT, DeepSeek, Qwen o glm-5.3-us de la región de EE. UU., que admite los tres protocolos — vea Región de EE. UU..
OpenAI SDK / Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.hop-base.com/v1",
api_key="sk-tu-clave",
)
resp = client.chat.completions.create(
model="glm-5.3",
messages=[{
"role": "user",
"content": "Explique en qué casos de uso destaca GLM-5.3",
}],
)
print(resp.choices[0].message.content)curl
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.3",
"messages": [{"role": "user", "content": "Hola, preséntese"}]
}'Próximos pasos
- GLM-5.3 Flash: multimodal y con menor precio unitario
- CC Switch: instalación y solución de problemas del enrutador local
- Códigos de error y reintentos
- Concurrencia, tiempos de espera y facturación