Este documento describe cómo llamar al servicio de inferencia de modelos Z.AI en Alibaba Cloud Model Studio.
Activación del servicio
- Vaya a la consola de Model Studio, busque ZHIPU/GLM, encuentre la tarjeta del modelo de texto Z.AI GLM-series y haga clic en Activate Now.
- En el cuadro de diálogo, confirme la activación y la autorización.
Inicio rápido
ZHIPU/GLM-5.3 es el modelo de la serie GLM y admite un contexto de 1M. Ejecute el siguiente código para llamar rápidamente al modelo ZHIPU/GLM-5.3 en modo de pensamiento.
Debe haber obtenido una clave de API y configurado la clave de API como variable de entorno. Si llama al modelo mediante un SDK, también debe instalar el SDK.
- Compatibilidad con OpenAI
enable_thinking no es un parámetro estándar de OpenAI. En el SDK de Python de OpenAI, se pasa en extra_body. En el SDK de Node.js, se pasa como un parámetro de nivel superior.- Python
- Node.js
- HTTP
Código de ejemplo
Respuesta
Llamada de herramienta en streaming
Los modelos ZHIPU/GLM-5.3 y ZHIPU/GLM-5.2 admiten el parámetro tool_stream. Este parámetro es un valor booleano cuyo valor predeterminado es false y solo funciona cuando stream es true. Cuando está habilitado, los arguments del parámetro tool_call de Function calling se devuelven incrementalmente como un flujo.
Los parámetros stream y tool_stream funcionan conjuntamente de la siguiente manera:
stream | tool_stream | Cómo |
|---|---|---|
true | true |
|
true | false (predeterminado) |
|
false | true/false |
|
- Compatible con OpenAI
- Python
- Node.js
- curl
Código de ejemplo
Control de pensamiento (thinking.type y reasoning_effort)
ZHIPU/GLM-5.3 siempre se ejecuta en modo de pensamiento y no admite desactivar el pensamiento. Mantenga thinking.type configurado en enabled (o mantenga enable_thinking configurado en true) y utilice reasoning_effort para controlar la profundidad de razonamiento.
Parámetro | Descripción | Valores admitidos |
|---|---|---|
| Controla si el pensamiento está habilitado. El valor predeterminado es |
|
| Controla la profundidad de razonamiento del modelo. Si no se especifica este parámetro, el valor predeterminado es |
|
Borrar razonamiento histórico (clear_thinking)
El parámetro clear_thinking controla si el reasoning_content (proceso de razonamiento) de turnos anteriores se pasa al modelo como contexto en conversaciones de múltiples turnos. Solo los modelos de la serie GLM admiten este parámetro.
true: Ignora elreasoning_contentde turnos anteriores y utiliza únicamente contenido sin razonamiento, como texto visible, llamadas a herramientas y resultados de herramientas, como contexto. Esto reduce la longitud del contexto y el costo.false(predeterminado): Conserva elreasoning_contentde turnos anteriores y lo proporciona al modelo junto con el contexto. Para habilitar el Pensamiento Conservado, debe pasar elreasoning_contenthistórico completo en los mensajes, sin modificaciones y en su orden original. Omitirlo, truncarlo, reescribirlo o reordenarlo degrada el efecto o impide que surta efecto.
assistant llevan reasoning_content. Cuando clear_thinking=true, el contenido de razonamiento histórico no se cuenta para el contexto, por lo que prompt_tokens es menor que con false (el valor predeterminado). El valor real depende de la longitud del reasoning_content histórico.
- Compatible con OpenAI
Otras funciones
| Modelo | Conversación multironda | Llamada de función | Salida estructurada | Búsqueda en Internet | Completado de prefijo | Caché de contexto | Control del esfuerzo de razonamiento |
|---|---|---|---|---|---|---|---|
| ZHIPU/GLM-5.3 | Compatible | Compatible | Compatible | No compatible | Compatible | Compatible | Compatiblereasoning_effort |
| ZHIPU/GLM-5.2 | Compatible | Compatible | CompatibleSolo modo sin pensamiento | No compatible | Compatible | Compatible | Compatiblereasoning_effort |
- El número mínimo de tokens en caché es 512, en comparación con 1024 para Model Studio.
Valores predeterminados de parámetros
Modelo | enable_thinking | temperature | top_p | top_k | repetition_penalty |
|---|---|---|---|---|---|
ZHIPU/GLM-5.3 | true (no se puede desactivar) | 1.0 | 0.95 | - | - |
ZHIPU/GLM-5.2 | true | 1.0 | 0.95 | - | - |
Lista de modelos y facturación
Los modelos de la serie GLM son modelos de razonamiento híbrido de Z.AI. Están diseñados para agentes inteligentes y ofrecen dos modos: pensamiento y no pensamiento. ZHIPU/GLM-5.3 solo admite el modo de pensamiento.
Para obtener información sobre la longitud del contexto del modelo y los precios, consulte la consola de Model Studioconsola de Model Studio.
La facturación se basa en los tokens de entrada y salida del modelo.
En el modo de pensamiento, la cadena de pensamiento se factura según los tokens de salida.
Códigos de error
Si ocurre un error, consulte Códigos de error para resolver el problema.
Los siguientes son códigos de error de servicio exclusivos de Z.AI. Los códigos de error HTTP son los mismos que los códigos de error generales de Model Studio. Consulte el enlace anterior.
Categoría de error | Código de error | Mensaje de error |
|---|---|---|
Error básico | 500 | Error interno |
Error de autenticación | 1000 | Error de autenticación |
1001 | No se recibió el parámetro de autenticación en el encabezado. No se puede realizar la autenticación. | |
1002 | El token de autenticación no es válido. Asegúrese de que el token de autenticación se pase correctamente. | |
1003 | El token de autenticación ha caducado. Regenérelo u obtenga uno nuevo. | |
1004 | La verificación del token de autenticación falló. | |
1100 | Lectura/escritura de cuenta | |
Error de cuenta | 1110 | Su cuenta está inactiva. Verifique la información de su cuenta. |
1111 | Su cuenta no existe. | |
1112 | Su cuenta está bloqueada. Póngase en contacto con el servicio de atención al cliente para desbloquearla. | |
1113 | Su cuenta tiene un saldo pendiente. Recargue su cuenta e inténtelo de nuevo. | |
1120 | No se puede acceder a su cuenta. Inténtelo de nuevo más tarde. | |
1121 | Cuenta bloqueada debido a una violación de política. | |
Error de llamada de API | 1200 | Error de llamada de API |
1210 | Parámetros de llamada de API no válidos. Consulte la documentación. | |
1211 | El modelo no existe. Verifique el código del modelo. | |
1212 | El modelo actual no admite el método de llamada | |
1213 | No se recibió el parámetro | |
1214 | El parámetro | |
1215 |
| |
1220 | No tiene permiso para acceder a | |
1221 | La API | |
1222 | La API | |
1230 | Error en el proceso de llamada de API. | |
1231 | Ya tiene una solicitud: | |
1234 | Error de red. ID de error: | |
1261 | El prompt es demasiado largo. | |
Error de bloqueo por política de API | 1300 | La llamada a la API fue bloqueada por una política. |
1301 | El sistema detectó contenido potencialmente inseguro o sensible en la entrada o salida. Evite utilizar instrucciones que puedan generar contenido sensible. Gracias por su cooperación. | |
1302 | La concurrencia para esta API es demasiado alta. Reduzca la concurrencia o póngase en contacto con el servicio de atención al cliente para aumentar el límite. | |
1303 | La tasa de solicitudes para esta API es demasiado alta. Reduzca la tasa de solicitudes o póngase en contacto con el servicio de atención al cliente para aumentar el límite. | |
1304 | Se ha alcanzado el límite diario de llamadas para esta API. Para aumentar el límite, póngase en contacto con el servicio de atención al cliente. | |
1305 | Se ha alcanzado el límite de tráfico para esta API. | |
1308 | Se ha alcanzado el límite de uso de | |
1309 | Su GLM Coding Plan ha caducado y no está disponible. Para restaurar el servicio, renueve su plan en https://bigmodel.cn/claude-code. | |
1310 | Se ha alcanzado el límite de uso semanal/mensual. Su límite se restablecerá en | |
1311 | Su plan de suscripción actual no incluye acceso a | |
1312 | Este modelo está experimentando un alto tráfico. Inténtelo de nuevo más tarde o cambie a otro modelo como | |
1313 | El uso de su cuenta infringe la política de uso justo y su tasa de solicitudes ha sido limitada. Para obtener más información, consulte "Terms and Agreements - Subscription and Auto-renewal Agreement". Para restaurar el acceso completo, vaya a Centro personal > Resumen del plan de programación y solicite levantar la restricción. |