> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Interfaz de todos los modelos GLM - Inicio rápido de Responses
> Invoca GLM con model e input. Modelos admitidos: glm-5.3, glm-5.3-flash, glm-5.3-flashx y glm-5.2. Configura max_output_tokens en 1024 o más para dejar espacio para el razonamiento y la respuesta.
Consulta más ejemplos y diferencias entre modelos en la [referencia completa](./responses-reference).
**BaseURL**: La BaseURL predeterminada es `https://direct.evolink.ai`, que ofrece mejor compatibilidad con los modelos de texto y las conexiones de larga duración. `https://api.evolink.ai` es el endpoint principal para los servicios multimodales y sirve como dirección de respaldo para los modelos de texto.
Usa POST /v1/responses y selecciona el modelo con model. Los campos mínimos obligatorios son model e input. Los ejemplos también configuran el presupuesto de salida y la intensidad de razonamiento para empezar.
Responses usa `reasoning.effort` anidado, en lugar de `reasoning_effort` o `thinking` en el nivel superior. Los tokens de razonamiento están incluidos en output\_tokens. Las tareas simples pueden devolver `reasoning_tokens=0`; eso no significa que se pueda desactivar el razonamiento.
Intensidad de razonamiento; se recomienda low.
**Reglas de compatibilidad de `glm-5.3` / `glm-5.3-flash` / `glm-5.3-flashx`**
| Valor enviado | Nivel efectivo de razonamiento |
| ---------------------- | ----------------------------------- |
| `low` / `high` / `max` | Sin cambios |
| `xhigh` | `max` |
| `medium` | `high` |
| `minimal` / `none` | `low`; el razonamiento sigue activo |
**`minimal` y `none` no desactivan el razonamiento de la serie 5.3.** Sus tokens se facturan como salida. Los valores desconocidos se mantienen sin conversión de compatibilidad; usa los valores indicados. Estas reglas no se aplican a glm-5.2.
En este endpoint, `glm-5.2` puede seguir produciendo tokens de razonamiento con none. Este valor no garantiza su desactivación.
## Leer la respuesta
Elementos de salida ordenados. Extrae text de las entradas content con `type=output_text` dentro de los elementos type=message. reasoning puede preceder a la respuesta y los turnos `function_call` pueden no tener texto. No leas siempre output\[0].
Una vez analizado el JSON de respuesta en response, extrae el texto así:
```python theme={null}
text = "".join(
part["text"]
for item in response.get("output", [])
if item.get("type") == "message"
for part in item.get("content", [])
if part.get("type") == "output_text"
)
print(text)
```
Máximo de tokens de salida de esta generación, incluido el razonamiento. Empieza con 1024 y ajusta según la tarea. Un límite pequeño puede agotarse durante el razonamiento y devolver solo elementos reasoning, sin respuesta. Comprueba status e incomplete\_details. El parámetro se llama `max_output_tokens`, no max\_tokens.
Consulta herramientas, imágenes, SSE y conversaciones de varios turnos en la [referencia completa](./responses-reference).
## OpenAPI
````yaml es/api-manual/language-series/glm/responses/responses-quickstart.json POST /v1/responses
openapi: 3.1.0
info:
title: Interfaz de todos los modelos GLM - Inicio rápido de Responses
description: >-
Invoca la serie GLM de Zhipu mediante el formato Responses compatible con
OpenAI. Admite glm-5.3, glm-5.3-flash, glm-5.3-flashx y glm-5.2. Las
funciones opcionales varían según el modelo.
license:
name: MIT
version: 1.0.0
servers:
- url: https://direct.evolink.ai
description: Producción (recomendado)
- url: https://api.evolink.ai
description: URL alternativa
security:
- bearerAuth: []
tags:
- name: Responses
description: API GLM Responses
paths:
/v1/responses:
post:
tags:
- Responses
summary: Inicio rápido de GLM Responses
description: >-
Invoca GLM con model e input. Modelos admitidos: glm-5.3, glm-5.3-flash,
glm-5.3-flashx y glm-5.2. Configura max_output_tokens en 1024 o más para
dejar espacio para el razonamiento y la respuesta.
Consulta más ejemplos y diferencias entre modelos en la [referencia
completa](./responses-reference).
operationId: glmResponsesQuick
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesQuickRequest'
examples:
basic:
summary: Conversación de texto básica
value:
model: glm-5.3-flash
input: Preséntate en una frase.
max_output_tokens: 1024
reasoning:
effort: low
stream:
summary: Salida SSE en streaming
value:
model: glm-5.3-flash
input: Preséntate en una frase.
max_output_tokens: 1024
reasoning:
effort: low
stream: true
flashx:
summary: Invocar GLM-5.3-FlashX
value:
model: glm-5.3-flashx
input: Preséntate en una frase.
max_output_tokens: 1024
reasoning:
effort: low
responses:
'200':
description: >-
Generación terminada o resultado incompleto; comprueba status. En
streaming se devuelve text/event-stream.
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesResponse'
example:
id: response_demo
object: response
created_at: 1789971757
model: glm-5.3-flash
status: completed
output:
- type: message
id: message_demo
status: completed
role: assistant
content:
- type: output_text
text: >-
Hola, soy GLM. Puedo ayudarte a conversar, escribir y
programar.
annotations: []
usage:
input_tokens: 17
output_tokens: 24
total_tokens: 41
input_tokens_details:
cached_tokens: 0
output_tokens_details:
reasoning_tokens: 0
error: null
text/event-stream:
schema:
type: string
example: >+
event: response.output_text.delta
data:
{"type":"response.output_text.delta","item_id":"message_demo","output_index":0,"content_index":0,"delta":"Hola"}
event: response.completed
data:
{"type":"response.completed","response":{"id":"response_demo","object":"response","created_at":1789971757,"model":"glm-5.3-flash","status":"completed","output":[{"type":"message","id":"message_demo","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hola","annotations":[]}]}],"usage":{"input_tokens":17,"output_tokens":3,"total_tokens":20},"error":null}}
'400':
description: >-
Parámetros no válidos: por ejemplo, falta input, reasoning tiene un
formato incorrecto o el modelo no admite previous_response_id.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: La clave API no es válida o ha caducado.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'402':
description: Créditos disponibles insuficientes.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: >-
Se ha superado el límite de solicitudes. Reintenta aumentando el
tiempo de espera.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Error del servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: Servicio no disponible temporalmente. Inténtalo más tarde.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ResponsesQuickRequest:
type: object
properties:
model:
type: string
description: >-
Elige un modelo GLM. Los cuatro admiten texto en este endpoint. Las
funciones opcionales varían según el modelo.
| ID del modelo | Entrada | Notas de razonamiento |
| --- | --- | --- |
| `glm-5.3` | Texto | Niveles efectivos: low / high / max; valores
compatibles en reasoning. No se puede desactivar el razonamiento. |
| `glm-5.3-flash` | Texto, imágenes | Igual que glm-5.3; usa
input_image para las imágenes. |
| `glm-5.3-flashx` | Texto, imágenes | Igual que glm-5.3; usa
input_image para las imágenes. |
| `glm-5.2` | Texto | none puede seguir produciendo tokens de
razonamiento y no garantiza su desactivación. |
enum:
- glm-5.3
- glm-5.3-flash
- glm-5.3-flashx
- glm-5.2
default: glm-5.3-flash
example: glm-5.3-flash
input:
description: >-
Obligatorio. Cadena de texto o array de elementos de entrada
Responses. El array admite mensajes, elementos de salida del modelo
reenviados y function_call_output. Para varios turnos, incluye el
historial completo en cada solicitud. Coloca el prompt del sistema
al principio como mensaje role=system. Las imágenes usan
input_image, solo con glm-5.3-flash y glm-5.3-flashx. No uses el
formato de bloques messages / image_url de Chat Completions.
oneOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/InputItem'
example: Preséntate en una frase.
max_output_tokens:
type: integer
minimum: 1
description: >-
Máximo de tokens de salida de esta generación, incluido el
razonamiento. Empieza con 1024 y ajusta según la tarea. Un límite
pequeño puede agotarse durante el razonamiento y devolver solo
elementos reasoning, sin respuesta. Comprueba status e
incomplete_details. El parámetro se llama max_output_tokens, no
max_tokens.
example: 1024
stream:
type: boolean
default: false
description: >-
Activa el streaming SSE. Lee el texto en delta de
response.output_text.delta. El evento final de éxito es
response.completed. Finaliza el turno y gestiona también
response.incomplete, response.failed o error. No esperes únicamente
[DONE] o el cierre de la conexión.
reasoning:
type: object
properties:
effort:
type: string
description: >-
Intensidad de razonamiento; se recomienda low.
**Reglas de compatibilidad de glm-5.3 / glm-5.3-flash /
glm-5.3-flashx**
| Valor enviado | Nivel efectivo de razonamiento |
| --- | --- |
| `low` / `high` / `max` | Sin cambios |
| `xhigh` | `max` |
| `medium` | `high` |
| `minimal` / `none` | low; el razonamiento sigue activo |
**minimal y none no desactivan el razonamiento de la serie
5.3.** Sus tokens se facturan como salida. Los valores
desconocidos se mantienen sin conversión de compatibilidad; usa
los valores indicados. Estas reglas no se aplican a glm-5.2.
En este endpoint, glm-5.2 puede seguir produciendo tokens de
razonamiento con none. Este valor no garantiza su desactivación.
enum:
- max
- xhigh
- high
- medium
- low
- minimal
- none
example: low
description: >-
Responses usa reasoning.effort anidado, en lugar de reasoning_effort
o thinking en el nivel superior. Los tokens de razonamiento están
incluidos en output_tokens. Las tareas simples pueden devolver
reasoning_tokens=0; eso no significa que se pueda desactivar el
razonamiento.
required:
- model
- input
ResponsesResponse:
type: object
properties:
id:
type: string
description: ID de esta respuesta. Pásalo sin cambios en previous_response_id.
example: response_demo
object:
type: string
const: response
created_at:
type: integer
description: Fecha de creación en segundos Unix.
model:
type: string
example: glm-5.3-flash
status:
type: string
description: >-
completed indica que ha terminado la generación del turno,
posiblemente solo con llamadas a herramientas. incomplete indica una
salida incompleta. Comprueba output y error.
enum:
- completed
- incomplete
- failed
- in_progress
- queued
output:
type: array
items:
$ref: '#/components/schemas/OutputItem'
description: >-
Elementos de salida ordenados. Extrae text de las entradas content
con type=output_text dentro de los elementos type=message. reasoning
puede preceder a la respuesta y los turnos function_call pueden no
tener texto. No leas siempre output[0].
output_text:
type: string
description: >-
Texto de respuesta agregado opcional; puede faltar. Los clientes
genéricos deben recorrer output.
usage:
$ref: '#/components/schemas/Usage'
error:
type:
- object
- 'null'
description: Error de respuesta; normalmente null si la solicitud tiene éxito.
additionalProperties: true
incomplete_details:
type: object
properties:
reason:
type: string
description: Detalles de una salida truncada, por ejemplo max_output_tokens.
metadata:
type:
- object
- 'null'
additionalProperties:
type: string
ErrorResponse:
type: object
properties:
error:
type: object
properties:
message:
type: string
type:
type: string
param:
type:
- string
- 'null'
code:
type:
- string
- integer
- 'null'
required:
- error
InputItem:
description: >-
Mensaje, resultado de función o elemento copiado sin cambios del output
anterior. Para resultados de herramientas, usa el call_id devuelto y
conserva los campos originales de los elementos de salida anteriores.
oneOf:
- $ref: '#/components/schemas/InputMessage'
- $ref: '#/components/schemas/FunctionCallOutput'
- type: object
properties:
type:
type: string
description: Tipo del elemento de salida reenviado.
enum:
- function_call
- reasoning
- web_search_call
id:
type: string
call_id:
type: string
name:
type: string
arguments:
type: string
description: Argumentos codificados como cadena JSON.
status:
type: string
action:
type: object
additionalProperties: true
description: Acción de búsqueda o acceso a una página de web_search_call.
required:
- type
OutputItem:
type: object
properties:
type:
type: string
description: >-
Tipos habituales: message, reasoning, function_call y
web_search_call.
enum:
- message
- reasoning
- function_call
- web_search_call
id:
type: string
status:
type: string
role:
type: string
content:
type: array
items:
type: object
properties:
type:
type: string
text:
type: string
annotations:
type: array
items:
type: object
description: >-
output_text en elementos message; puede ser reasoning_text en
elementos reasoning.
summary:
type: array
items:
type: object
properties:
type:
type: string
text:
type: string
description: >-
El razonamiento también puede devolverse mediante summary_text. No
supongas que todos los elementos reasoning tienen content.
call_id:
type: string
description: Identificador de la llamada a función para devolver su resultado.
name:
type: string
description: Nombre de la función.
arguments:
type: string
description: >-
Argumentos de la función como cadena JSON. Analízalos y valídalos
antes de ejecutarla.
action:
type: object
additionalProperties: true
description: Acción de búsqueda o acceso a una página de web_search_call.
required:
- type
Usage:
type: object
properties:
input_tokens:
type: integer
description: >-
Total de tokens de entrada, incluidos los que coinciden con la
caché.
output_tokens:
type: integer
description: Total de tokens de salida, incluido el razonamiento.
total_tokens:
type: integer
description: Suma de tokens de entrada y salida.
input_tokens_details:
type: object
properties:
cached_tokens:
type: integer
description: >-
Subconjunto de tokens de entrada encontrado en caché; no lo
sumes de nuevo a input_tokens. La caché de prefijos es
automática y no requiere cache_control explícito. Usa el valor
devuelto para conocer los aciertos.
output_tokens_details:
type: object
properties:
reasoning_tokens:
type: integer
description: >-
Subconjunto de tokens de salida usado para razonar; no lo
cuentes de nuevo en output_tokens. Este detalle puede faltar o
valer 0.
InputMessage:
type: object
properties:
role:
type: string
enum:
- system
- user
- assistant
content:
description: >-
Cadena de texto o array de bloques de entrada. Al reenviar una
salida assistant existente, puedes conservar sus bloques output_text
sin cambios.
oneOf:
- type: string
- type: array
items:
oneOf:
- $ref: '#/components/schemas/InputText'
- $ref: '#/components/schemas/InputImage'
- $ref: '#/components/schemas/OutputText'
required:
- role
- content
FunctionCallOutput:
type: object
properties:
type:
type: string
const: function_call_output
call_id:
type: string
description: call_id del function_call original.
output:
type: string
description: Resultado de función, normalmente una cadena codificada en JSON.
required:
- type
- call_id
- output
InputText:
type: object
properties:
type:
type: string
const: input_text
text:
type: string
required:
- type
- text
InputImage:
type: object
properties:
type:
type: string
const: input_image
image_url:
type: string
description: >-
URL pública de imagen o Data URL Base64, como
data:image/png;base64,... para PNG. Solo glm-5.3-flash /
glm-5.3-flashx admiten imágenes; usa solo texto con glm-5.3 y
glm-5.2.
required:
- type
- image_url
OutputText:
type: object
properties:
type:
type: string
const: output_text
text:
type: string
annotations:
type: array
items:
type: object
required:
- type
- text
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Envía Bearer YOUR_API_KEY en la cabecera Authorization.
````