Saltar al contenido

GLM-5.3

Llame a GLM-5.3 con la API de Chat Completions compatible con OpenAI.

ElementoValor
Base URLhttps://api.hop-base.com/v1
Modeloglm-5.3
ChatSolo 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.3 se 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.2 solo tienen que cambiar el nombre del modelo a glm-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ámetroObligatorioTipo y límitesPredeterminadoDescripción
modelObligatorioglm-5.3—Coincidencia exacta
messagesObligatorioArray no vacío, solo texto—Ausente o vacío: 400 de la pasarela; con imágenes devuelve 400. Contexto de 1M
max_tokensOpcionalEntero 1–131.072Del servicioFuera del rango devuelve 400 max_tokens参数非法:限制数值范围[1,131072]; lo comparten razonamiento y respuesta
reasoning_effortOpcionallow / high / maxNivel predeterminado del modeloSiempre piensa: none u otro valor que lo desactive devuelve 400
temperature, top_pOpcionalSe transmiten; sin rango en la pasarelaDel servicioControles de muestreo, se reenvían tal cual
tools, tool_choiceOpcionalComo en OpenAIautoUn resultado tool devuelto debe corresponder a un ID de llamada del turno anterior; si no, 400 No tool call found for function call output
streamOpcionalBooleanofalseCon true responde con eventos SSE
stream_options.include_usageOpcionalBooleanofalseDebe 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

CampoValor
Dirección de la API / Base URLhttps://api.hop-base.com/v1
Clave APIsk-tu-clave
Modeloglm-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