> ## 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.
# MiniMax-M3.1-Flash - API Responses
> - Invoca MiniMax-M3.1-Flash mediante el protocolo Responses de OpenAI
- **Formato de entrada**: `input` admite texto sin formato o un arreglo de elementos de entrada: mensajes, llamadas a funciones y resultados de funciones
- **Entrada multimodal**: combina bloques `input_text`, `input_image` e `input_video` en el `content` del mensaje
- **Instrucciones de sistema**: se pasan mediante `instructions`, equivalente a un mensaje system inicial
- **Razonamiento**: siempre activado; `reasoning.effort` controla la profundidad. El razonamiento se devuelve como elementos de salida `reasoning`
- **Streaming**: eventos SSE semánticos; termina con `response.completed` y **no envía `[DONE]`**
- **Herramientas**: admite Function Calling
- **Caché de contexto**: los prefijos idénticos se reutilizan automáticamente; los tokens reutilizados se indican en `usage.input_tokens_details.cached_tokens`
**Sin estado**: las respuestas no se almacenan y no se admite `previous_response_id`. En cada turno, añada a `input` todos los elementos del `output` anterior en su orden y estructura originales, conservando todos los campos, incluidos `content`, `summary` y `encrypted_content` de los elementos de razonamiento. Tras ejecutar una herramienta, añada un elemento `function_call_output` con el mismo `call_id` que la llamada a función.
**Eventos de streaming**: `response.created`, `response.in_progress`, `response.output_item.added`, `response.content_part.added`, `response.reasoning_text.delta` / `response.reasoning_text.done`, `response.output_text.delta` / `response.output_text.done`, `response.content_part.done` y `response.output_item.done`. El evento final es `response.completed`. Cada evento incluye `sequence_number` para indicar su orden.
**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.
## OpenAPI
````yaml es/api-manual/language-series/minimax-m3.1-flash/minimax-m3.1-flash-responses.json POST /v1/responses
openapi: 3.1.0
info:
title: 'MiniMax-M3.1-Flash: referencia completa de parámetros (API Responses)'
description: >-
Referencia completa de la API Responses de MiniMax-M3.1-Flash.
**Capacidades del modelo**:
- Ventana de contexto: **1,000,000 tokens** (1M)
- Salida máxima: **524,288 tokens** (512K); se recomiendan **131,072
tokens** (128K), incluidos los tokens de razonamiento
- Razonamiento: siempre activado; `reasoning.effort` controla la
profundidad, con `max` como valor predeterminado
- Entrada multimodal: texto, imágenes y video
- Herramientas: admite Function Calling
- Caché de contexto: los prefijos idénticos se reutilizan automáticamente y
se facturan a la tarifa de acierto de caché
**Sin estado**: las respuestas no se guardan. En conversaciones de varios
turnos, el cliente debe enviar el historial completo en cada solicitud.
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: Generación de chat
description: Endpoints relacionados con la generación de chat de IA
paths:
/v1/responses:
post:
tags:
- Generación de chat
summary: API Responses de MiniMax-M3.1-Flash (compatible con OpenAI)
description: >-
- Invoca MiniMax-M3.1-Flash mediante el protocolo Responses de OpenAI
- **Formato de entrada**: `input` admite texto sin formato o un arreglo
de elementos de entrada: mensajes, llamadas a funciones y resultados de
funciones
- **Entrada multimodal**: combina bloques `input_text`, `input_image` e
`input_video` en el `content` del mensaje
- **Instrucciones de sistema**: se pasan mediante `instructions`,
equivalente a un mensaje system inicial
- **Razonamiento**: siempre activado; `reasoning.effort` controla la
profundidad. El razonamiento se devuelve como elementos de salida
`reasoning`
- **Streaming**: eventos SSE semánticos; termina con
`response.completed` y **no envía `[DONE]`**
- **Herramientas**: admite Function Calling
- **Caché de contexto**: los prefijos idénticos se reutilizan
automáticamente; los tokens reutilizados se indican en
`usage.input_tokens_details.cached_tokens`
**Sin estado**: las respuestas no se almacenan y no se admite
`previous_response_id`. En cada turno, añada a `input` todos los
elementos del `output` anterior en su orden y estructura originales,
conservando todos los campos, incluidos `content`, `summary` y
`encrypted_content` de los elementos de razonamiento. Tras ejecutar una
herramienta, añada un elemento `function_call_output` con el mismo
`call_id` que la llamada a función.
**Eventos de streaming**: `response.created`, `response.in_progress`,
`response.output_item.added`, `response.content_part.added`,
`response.reasoning_text.delta` / `response.reasoning_text.done`,
`response.output_text.delta` / `response.output_text.done`,
`response.content_part.done` y `response.output_item.done`. El evento
final es `response.completed`. Cada evento incluye `sequence_number`
para indicar su orden.
operationId: createResponseMiniMaxM31Flash
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesRequest'
examples:
simple_text:
summary: Conversación de texto de un solo turno
value:
model: MiniMax-M3.1-Flash
input: Explain recursion in one sentence.
max_output_tokens: 131072
with_instructions:
summary: Uso de instrucciones de sistema
value:
model: MiniMax-M3.1-Flash
instructions: >-
You are a technical documentation assistant. Keep your
answers concise.
input: Explain how context caching works.
max_output_tokens: 131072
multi_turn:
summary: >-
Conversación de varios turnos (arreglo de elementos de
entrada)
value:
model: MiniMax-M3.1-Flash
input:
- type: message
role: user
content: Suggest three names for a note-taking app.
- type: message
role: assistant
content: NoteFlow, ClearPage, QuickNote.
- type: message
role: user
content: Suggest five alternatives to the second name.
max_output_tokens: 131072
reasoning_effort:
summary: Ajuste de la profundidad de razonamiento
value:
model: MiniMax-M3.1-Flash
input: >-
A bat and a ball cost 1.10 in total. The bat costs 1.00 more
than the ball. How much does the ball cost?
reasoning:
effort: high
max_output_tokens: 131072
vision_url:
summary: Comprensión de imágenes
value:
model: MiniMax-M3.1-Flash
input:
- type: message
role: user
content:
- type: input_text
text: Describe this image.
- type: input_image
image_url: https://example.com/photo.jpg
max_output_tokens: 131072
video_url:
summary: Comprensión de video
value:
model: MiniMax-M3.1-Flash
input:
- type: message
role: user
content:
- type: input_text
text: Summarize this video.
- type: input_video
video_url:
url: https://example.com/video.mp4
fps: 1
detail: default
max_output_tokens: 131072
function_calling:
summary: Function Calling (invocación de herramientas)
value:
model: MiniMax-M3.1-Flash
input: Check the stock for product demo-item-001.
tools:
- type: function
name: get_product_stock
description: Get the current stock level for a product.
parameters:
type: object
properties:
product_id:
type: string
description: Product identifier.
required:
- product_id
max_output_tokens: 131072
function_result:
summary: >-
Envío del resultado de la herramienta y continuación de la
respuesta
value:
model: MiniMax-M3.1-Flash
reasoning:
effort: medium
max_output_tokens: 131072
input:
- type: message
role: user
content: >-
Use get_product_stock to check product demo-item-001.
After receiving the tool result, report whether it is in
stock and its quantity. Do not guess the stock level.
- id: 0725233e825de1d0656437967fc024e1_msg
type: message
status: completed
role: assistant
content:
- type: output_text
text: I'll check the stock level for that product now.
annotations: []
- id: 0725233e825de1d0656437967fc024e1_fc_0
type: function_call
status: completed
call_id: call_function_izs7qcnzfksd_1
name: get_product_stock
arguments: '{"product_id": "demo-item-001"}'
- type: function_call_output
call_id: call_function_izs7qcnzfksd_1
output: >-
{"product_id": "demo-item-001", "in_stock": true,
"quantity": 24}
tools:
- type: function
name: get_product_stock
description: Get the current stock level for a product.
parameters:
type: object
properties:
product_id:
type: string
description: Product identifier.
required:
- product_id
tool_choice: auto
streaming:
summary: Salida en streaming
value:
model: MiniMax-M3.1-Flash
input: Write a short poem about autumn.
stream: true
max_output_tokens: 131072
reasoning_history:
summary: Continuar con el historial completo de razonamiento
value:
model: MiniMax-M3.1-Flash
reasoning:
effort: medium
max_output_tokens: 131072
input:
- type: message
role: user
content: >-
Find the smallest positive integer n such that n mod 7 =
3, n mod 11 = 5, and n mod 13 = 7. Return only n.
- id: 0725233a85e23431681447327cbcd9d2_rs
type: reasoning
status: completed
summary: []
content:
- type: reasoning_text
text: >-
We need solve CRT. Need only n. Compute. n=3 mod7, 5
mod11,7 mod13. Product 1001. Let's solve.
Use n=3+7a. mod11: 3+7a=5 =>7a=2 mod11. inverse7=8
(56=1), a=16=5 mod11. a=5+11b. n=38+77b. mod13:
38+77b = 12+12b mod13 (77=12,38=12) equals7
=>12b=-5=8 mod13. inverse12=12, b=96 mod13 =5? 91
remainder5. n=38+385=423. Check 423 mod7 3 (420),
mod11 5 (418), mod13 7 (416). Smallest positive 423.
Only n.
encrypted_content: >-
Ahlub3JtYWwtcmVhc29uaW5nLTIwMjYxMDExjehfvIf2rUinmic9ZiAutly0DD3lHqWEni9ENDziUw0nX-F6VPZLM7x1NbRWbytJNcLH9XQIa-KLYgd-it6XmXzYLvck3xOPOG9wtDdxUnjdBhuuj9dkWrkx0kbK8MFT5UreZ7EcxoRZybrs3oELf2BK_WtDUFOm_FbZXKwNbg76pTCFDoRke0Er0GMWjmi5L8GE7hGnvvBQjHXrwQ88G0L2p6STay-n1FJ5prqz6Q4LEF-xu7FqGjDmh9haliI638ivcQ9XGo9_DLUrtKMh1K4UYN87j2H7vbjbJPJaw6oJ61ZF8Ngk1FSuHUvLB540QKwBJKnClMcvw-ih3CdKRdSTPRfIYlsYOkNCwEWrLwHarLTHG5HzeakMO_5usxOAvzXVDUKRIX7W62x9xKCnVl_Gp0E91dLtlU3U8j_ZZvYCj9pMvd_n_Ba82OUpFxvoXv2R2H1H8bfzztGg5E88fH6OMwoMS5OYa45nCoRFA11Bw7G8OEVqBiPzS48EY1JPjPTC5lBco0CUoeUAHPXeD7jmO-D3LhIL1-3erJ_mxP0ZeiCWUckYaFE2EliolooAHqkoVBmy5Q
- id: 0725233a85e23431681447327cbcd9d2_msg
type: message
status: completed
role: assistant
content:
- type: output_text
text: '423'
annotations: []
- type: message
role: user
content: Add one to that result. Return only the new integer.
responses:
'200':
description: Generado correctamente
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesResponse'
examples:
with_reasoning:
summary: Respuesta con razonamiento
value:
id: 0725233a85e23431681447327cbcd9d2
object: response
created_at: 1792405562
model: MiniMax-M3.1-Flash
status: completed
output:
- id: 0725233a85e23431681447327cbcd9d2_rs
type: reasoning
status: completed
summary: []
content:
- type: reasoning_text
text: >-
We need solve CRT. Need only n. Compute. n=3 mod7,
5 mod11,7 mod13. Product 1001. Let's solve.
Use n=3+7a. mod11: 3+7a=5 =>7a=2 mod11. inverse7=8
(56=1), a=16=5 mod11. a=5+11b. n=38+77b. mod13:
38+77b = 12+12b mod13 (77=12,38=12) equals7
=>12b=-5=8 mod13. inverse12=12, b=96 mod13 =5? 91
remainder5. n=38+385=423. Check 423 mod7 3 (420),
mod11 5 (418), mod13 7 (416). Smallest positive
423. Only n.
encrypted_content: >-
Ahlub3JtYWwtcmVhc29uaW5nLTIwMjYxMDExjehfvIf2rUinmic9ZiAutly0DD3lHqWEni9ENDziUw0nX-F6VPZLM7x1NbRWbytJNcLH9XQIa-KLYgd-it6XmXzYLvck3xOPOG9wtDdxUnjdBhuuj9dkWrkx0kbK8MFT5UreZ7EcxoRZybrs3oELf2BK_WtDUFOm_FbZXKwNbg76pTCFDoRke0Er0GMWjmi5L8GE7hGnvvBQjHXrwQ88G0L2p6STay-n1FJ5prqz6Q4LEF-xu7FqGjDmh9haliI638ivcQ9XGo9_DLUrtKMh1K4UYN87j2H7vbjbJPJaw6oJ61ZF8Ngk1FSuHUvLB540QKwBJKnClMcvw-ih3CdKRdSTPRfIYlsYOkNCwEWrLwHarLTHG5HzeakMO_5usxOAvzXVDUKRIX7W62x9xKCnVl_Gp0E91dLtlU3U8j_ZZvYCj9pMvd_n_Ba82OUpFxvoXv2R2H1H8bfzztGg5E88fH6OMwoMS5OYa45nCoRFA11Bw7G8OEVqBiPzS48EY1JPjPTC5lBco0CUoeUAHPXeD7jmO-D3LhIL1-3erJ_mxP0ZeiCWUckYaFE2EliolooAHqkoVBmy5Q
- id: 0725233a85e23431681447327cbcd9d2_msg
type: message
status: completed
role: assistant
content:
- type: output_text
text: '423'
annotations: []
output_text: '423'
usage:
input_tokens: 239
output_tokens: 190
total_tokens: 429
input_tokens_details:
cached_tokens: 174
output_tokens_details:
reasoning_tokens: 189
error: null
incomplete_details: null
instructions: null
metadata: {}
tools: null
tool_choice: auto
temperature: 1
top_p: 0.95
text:
format:
type: text
reasoning:
effort: medium
summary: null
max_output_tokens: 2048
max_tool_calls: null
parallel_tool_calls: true
previous_response_id: null
conversation: null
store: false
service_tier: null
safety_identifier: null
truncation: disabled
function_call:
summary: Llamada a herramienta
value:
id: 0725233e825de1d0656437967fc024e1
object: response
created_at: 1792405566
model: MiniMax-M3.1-Flash
status: completed
output:
- id: 0725233e825de1d0656437967fc024e1_msg
type: message
status: completed
role: assistant
content:
- type: output_text
text: I'll check the stock level for that product now.
annotations: []
- id: 0725233e825de1d0656437967fc024e1_fc_0
type: function_call
status: completed
call_id: call_function_izs7qcnzfksd_1
name: get_product_stock
arguments: '{"product_id": "demo-item-001"}'
output_text: I'll check the stock level for that product now.
usage:
input_tokens: 479
output_tokens: 43
total_tokens: 522
input_tokens_details:
cached_tokens: 174
error: null
incomplete_details: null
instructions: null
metadata: {}
tools:
- type: function
name: get_product_stock
description: Get the current stock level for a product.
parameters:
properties:
product_id:
description: Product identifier.
type: string
required:
- product_id
type: object
tool_choice: auto
temperature: 1
top_p: 0.95
text:
format:
type: text
reasoning:
effort: medium
summary: null
max_output_tokens: 2048
max_tool_calls: null
parallel_tool_calls: true
previous_response_id: null
conversation: null
store: false
service_tier: null
safety_identifier: null
truncation: disabled
incomplete:
summary: Límite de salida alcanzado (status=incomplete)
value:
id: 072514375f41347e5f4de3c6ceb8fd87
object: response
created_at: 1792401719
model: MiniMax-M3.1-Flash
status: incomplete
output:
- id: 072514375f41347e5f4de3c6ceb8fd87_rs
type: reasoning
status: completed
summary: []
content:
- type: reasoning_text
text: I need to explain the process step by step.
encrypted_content: >-
Ahlub3JtYWwtcmVhc29uaW5nLTIwMjYxMDExv21cbZ66-fbVryqevLX4LJWxZguAnQBWN1xlN33KB5qCPkM8IMN2pVWWIclGFlVn6ZZ0CBzkPpHqkdCVqpYbDWc3gQl2Qmf0uD4s3wo
output_text: null
usage:
input_tokens: 211
output_tokens: 8
total_tokens: 219
input_tokens_details:
cached_tokens: 195
output_tokens_details:
reasoning_tokens: 8
error: null
incomplete_details:
reason: max_output_tokens
instructions: null
metadata: {}
tools: null
tool_choice: auto
temperature: 1
top_p: 0.95
text:
format:
type: text
reasoning:
effort: max
summary: null
max_output_tokens: 8
max_tool_calls: null
parallel_tool_calls: true
previous_response_id: null
conversation: null
store: false
service_tier: null
safety_identifier: null
truncation: disabled
'400':
description: Parámetros de solicitud no válidos
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: invalid_prompt
message: Invalid request parameters
type: invalid_request_error
'401':
description: No autenticado, token no válido o expirado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 401
message: Invalid authentication credentials
type: authentication_error
'402':
description: Cuota insuficiente, se requiere recarga
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 402
message: Insufficient quota
type: insufficient_quota
'403':
description: Acceso denegado a este modelo
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 403
message: Model access denied
type: permission_error
'404':
description: Recurso no encontrado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 404
message: Model not found
type: not_found_error
'413':
description: Cuerpo de la solicitud demasiado grande
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 413
message: Request entity too large
type: invalid_request_error
'429':
description: Límite de frecuencia superado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 429
message: Rate limit exceeded
type: rate_limit_error
'500':
description: Error interno del servidor
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 500
message: Internal server error
type: server_error
'502':
description: Puerta de enlace no válida
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 502
message: Bad gateway
type: server_error
'503':
description: Servicio temporalmente no disponible
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 503
message: Service temporarily unavailable
type: server_error
components:
schemas:
ResponsesRequest:
type: object
required:
- model
- input
properties:
model:
type: string
description: ID del modelo
enum:
- MiniMax-M3.1-Flash
example: MiniMax-M3.1-Flash
input:
type:
- string
- array
description: >-
Entrada del modelo
- **Cadena**: el texto completo se trata como un único mensaje
`user`
- **Arreglo**: lista de elementos de entrada; admite `message`,
`function_call`, `function_call_output` y `reasoning`
**Multimodal**: combina bloques `input_text`, `input_image` e
`input_video` en el arreglo `content` de un elemento `message`.
**Conversaciones de varios turnos**: la API no mantiene estado;
incluye el historial completo en el arreglo para continuar la
conversación.
items:
$ref: '#/components/schemas/InputItem'
example: Explain recursion in one sentence.
instructions:
type: string
description: >-
Instrucciones a nivel de sistema, equivalentes a un mensaje system
insertado al principio; sirven para fijar el rol, el tono y las
restricciones de salida.
example: >-
You are a technical documentation assistant. Keep your answers
concise.
stream:
type: boolean
description: >-
Indica si la respuesta se devuelve en streaming
- `false` (predeterminado): devuelve el objeto de respuesta completo
de una vez
- `true`: transmite eventos SSE semánticos y termina con
`response.completed`; **no envía `[DONE]`**
default: false
example: false
max_output_tokens:
type: integer
description: >-
Máximo de tokens de salida de esta generación, **incluidos el
razonamiento y la respuesta**
- Recomendado: **131,072** (128K); máximo: **524,288** (512K)
- Un valor demasiado bajo puede agotar el límite durante el
razonamiento y devolver `status: "incomplete"` sin elementos de
salida `message`
minimum: 1
maximum: 524288
example: 131072
reasoning:
type: object
description: >-
Configuración de razonamiento. MiniMax-M3.1-Flash siempre realiza
razonamiento, que se devuelve como elementos de salida `reasoning`.
Sus tokens se incluyen en la salida y se facturan a la tarifa de
salida.
properties:
effort:
type: string
description: >-
Profundidad de razonamiento; el valor predeterminado es `max`.
Los niveles más altos suelen aumentar el consumo de tokens de
razonamiento y el tiempo de respuesta.
enum:
- low
- medium
- high
- xhigh
- max
default: max
example: high
temperature:
type: number
description: Temperatura de muestreo, fija en `1`.
enum:
- 1
default: 1
example: 1
top_p:
type: number
description: 'Umbral de muestreo de núcleo; valor predeterminado: 0.95.'
minimum: 0
maximum: 1
default: 0.95
example: 0.95
tools:
type: array
description: >-
Lista de herramientas disponibles para el modelo. Actualmente solo
admite el tipo `function`. El cliente ejecuta las funciones y
devuelve sus resultados como elementos de entrada
`function_call_output`.
items:
$ref: '#/components/schemas/Tool'
tool_choice:
type: string
description: >-
Estrategia de selección de herramientas. Solo admite `auto`: el
modelo decide si debe invocar una herramienta.
enum:
- auto
default: auto
example: auto
text:
type: object
description: >-
Configuración del formato de salida de texto. `format.type` solo
admite `text`.
properties:
format:
type: object
properties:
type:
type: string
enum:
- text
default: text
description: Tipo de formato de salida
metadata:
type: object
description: >-
Metadatos de la solicitud. Tanto las claves como los valores deben
ser cadenas.
additionalProperties:
type: string
ResponsesResponse:
type: object
description: >-
Objeto de respuesta de la API Responses. Además de los campos
siguientes, incluye la configuración de la solicitud, como `tools`,
`tool_choice`, `temperature`, `top_p`, `text`, `reasoning` y
`max_output_tokens`.
properties:
id:
type: string
description: Identificador único de esta respuesta
example: 072514d63605b7a0c83f1672230c398c
object:
type: string
description: Tipo de objeto, siempre `response`
example: response
created_at:
type: integer
description: Fecha de creación como marca de tiempo Unix (segundos)
example: 1792401878
status:
type: string
description: >-
Estado de la respuesta
- `completed`: finalización normal
- `incomplete`: salida truncada; consulta el motivo en
`incomplete_details`
- `failed`: generación fallida; consulta el motivo en `error`
enum:
- completed
- incomplete
- failed
example: completed
model:
type: string
description: ID del modelo que realmente generó esta respuesta
example: MiniMax-M3.1-Flash
output:
type: array
description: >-
Lista de elementos de salida en orden de generación:
- `reasoning`: razonamiento; ID con formato `_rs`. Contiene
`content` (lista de bloques `reasoning_text`), `summary` (arreglo
vacío) y `encrypted_content`
- `message`: respuesta final; ID con formato `_msg`. Contiene
`content` (lista de bloques `output_text`)
- `function_call`: llamada a función iniciada por el modelo; ID con
formato `_fc_`. Contiene `call_id`, `name` y `arguments`.
El cliente debe ejecutarla y devolver el resultado mediante
`function_call_output`
items:
type: object
output_text:
type:
- string
- 'null'
description: >-
Campo de acceso directo con todo el texto de `output_text`
concatenado. Es `null` si no hay salida de texto.
error:
type:
- object
- 'null'
description: Motivo del fallo; `null` si tuvo éxito
incomplete_details:
type:
- object
- 'null'
description: >-
Motivo del truncamiento; `null` si la salida no se ha truncado.
`reason` puede ser `max_output_tokens` (límite de salida alcanzado)
o `content_filter` (seguridad del contenido).
usage:
$ref: '#/components/schemas/Usage'
ErrorResponse:
type: object
description: Respuesta de error
properties:
error:
type: object
properties:
code:
type:
- integer
- string
- 'null'
description: Código de error
example: invalid_prompt
message:
type: string
description: Descripción del error
example: Invalid request parameters
type:
type: string
description: Tipo de error
example: invalid_request_error
InputItem:
title: Elemento de entrada
description: >-
Elemento de entrada: mensaje, historial de razonamiento, llamada a
función o resultado de función.
oneOf:
- $ref: '#/components/schemas/MessageItem'
- $ref: '#/components/schemas/ReasoningItem'
- $ref: '#/components/schemas/FunctionCallItem'
- $ref: '#/components/schemas/FunctionCallOutputItem'
Tool:
type: object
title: Definición de herramienta
required:
- type
- name
properties:
type:
type: string
description: Tipo de herramienta. Actualmente solo admite `function`.
enum:
- function
example: function
name:
type: string
description: Nombre de la función
example: get_product_stock
description:
type: string
description: >-
Descripción de la función. Una descripción clara ayuda al modelo a
decidir cuándo invocarla.
example: Get the current stock level for a product.
parameters:
type: object
description: Definición de parámetros en formato JSON Schema.
example:
type: object
properties:
product_id:
type: string
description: Product identifier.
required:
- product_id
Usage:
type: object
description: Estadísticas de uso de tokens, con desglose de caché y razonamiento.
properties:
input_tokens:
type: integer
description: Total de tokens de entrada, incluidos los reutilizados de la caché.
example: 207
input_tokens_details:
type: object
description: Desglose detallado de los tokens de entrada
properties:
cached_tokens:
type: integer
description: >-
Número de tokens de entrada reutilizados de la caché
Los tokens reutilizados se facturan a la tarifa de acierto de
caché. Los restantes = `input_tokens - cached_tokens` se
facturan a la tarifa estándar de entrada.
example: 174
output_tokens:
type: integer
description: Número de tokens de salida (incluida la parte de razonamiento)
example: 32
output_tokens_details:
type: object
description: Desglose detallado de los tokens de salida
properties:
reasoning_tokens:
type: integer
description: >-
Número de tokens generados durante el razonamiento, ya incluidos
en `output_tokens`.
example: 9
total_tokens:
type: integer
description: Total de tokens = input_tokens + output_tokens
example: 239
MessageItem:
type: object
title: Elemento de mensaje
description: >-
Mensaje de la conversación. Conserve todos los campos devueltos al
enviar el historial del asistente.
required:
- role
- content
properties:
type:
type: string
enum:
- message
default: message
id:
type: string
description: Identificador del elemento de salida. Consérvelo en el historial.
status:
type: string
description: Estado del elemento de salida. Consérvelo en el historial.
role:
type: string
description: >-
Rol del mensaje, se usa solo con `type: message`. `developer` se
trata como `system`.
enum:
- user
- assistant
- system
- developer
example: user
content:
type:
- string
- array
description: >-
Contenido del mensaje; solo se usa con `type: message`. Admite texto
sin formato o un arreglo de bloques de contenido.
**Tipos de bloques de contenido**:
- `input_text`: texto, en el campo `text`
- `input_image`: imagen, en el campo `image_url`
- `input_video`: video, en el campo `video_url`
- `output_text`: texto de respuestas anteriores del asistente
Tamaño máximo del cuerpo de la solicitud: 64 MB.
items:
$ref: '#/components/schemas/ContentPart'
example: Explain recursion in one sentence.
ReasoningItem:
type: object
title: Elemento de razonamiento
description: >-
Razonamiento devuelto en el turno anterior. Para continuar la
conversación, conserve el elemento completo, incluidos `id`, `status`,
`summary`, `content` y `encrypted_content`.
required:
- type
properties:
type:
type: string
enum:
- reasoning
id:
type: string
description: Identificador del elemento de salida. Consérvelo en el historial.
status:
type: string
description: Estado del elemento de salida. Consérvelo en el historial.
summary:
type: array
description: >-
Resumen del razonamiento. Se conserva sin cambios al enviar el
historial de la conversación.
items:
type: object
content:
type: array
description: Bloques de razonamiento. Consérvelos sin cambios en el historial.
items:
$ref: '#/components/schemas/ReasoningContentPart'
encrypted_content:
type: string
description: >-
Datos opacos de razonamiento. Consérvelos sin cambios en el
historial.
FunctionCallItem:
type: object
title: Llamada a función
description: >-
Llamada a función devuelta por el modelo, asociada con un elemento
`function_call_output` mediante `call_id`.
required:
- type
- call_id
- name
- arguments
properties:
type:
type: string
enum:
- function_call
id:
type: string
description: Identificador del elemento de salida. Consérvelo en el historial.
status:
type: string
description: Estado del elemento de salida. Consérvelo en el historial.
call_id:
type: string
description: >-
Identificador de la llamada a función; `function_call` y
`function_call_output` se emparejan mediante él.
name:
type: string
description: >-
Nombre de la función invocada, se usa solo con `type:
function_call`.
arguments:
type: string
description: >-
Argumentos de la llamada a función como cadena JSON, se usan solo
con `type: function_call`.
FunctionCallOutputItem:
type: object
title: Resultado de función
description: >-
Resultado de una función ejecutada por el cliente, asociado con su
llamada mediante `call_id`.
required:
- type
- call_id
- output
properties:
type:
type: string
enum:
- function_call_output
call_id:
type: string
description: >-
Identificador de la llamada a función; `function_call` y
`function_call_output` se emparejan mediante él.
output:
type: string
description: >-
Resultado de la ejecución de la función, se usa solo con `type:
function_call_output`.
ContentPart:
type: object
title: Bloque de contenido
required:
- type
properties:
type:
type: string
enum:
- input_text
- input_image
- input_video
- output_text
description: Tipo de bloque de contenido
text:
type: string
description: Contenido de texto (`input_text` / `output_text`).
image_url:
description: >-
Entrada de imagen; se usa con `type: input_image`. Admite una URL /
data URL Base64 como cadena o un objeto `{"url": "...", "detail":
"low | default | high"}` para controlar la precisión del análisis.
Una precisión mayor capta más detalles y consume más tokens. Admite
JPEG / PNG / GIF / WEBP; máximo 10 MB por imagen.
oneOf:
- type: string
- type: object
required:
- url
properties:
url:
type: string
description: URL de imagen o data URL Base64.
detail:
type: string
enum:
- low
- default
- high
default: default
description: Precisión del análisis
video_url:
description: >-
Entrada de video; se usa con `type: input_video`. Admite una URL /
data URL Base64 como cadena o un objeto `{"url": "...", "fps": 1,
"detail": "default", "max_long_side_pixel": ...}`. `fps` es la
frecuencia de extracción de fotogramas; su valor predeterminado es 1
y su rango es [0.2, 5]. Los valores más bajos consumen menos tokens.
Admite MP4 / AVI / MOV / MKV; máximo 50 MB mediante URL / Base64.
Para videos más grandes, usa una referencia de archivo
`mm_file://{file_id}`.
oneOf:
- type: string
- type: object
required:
- url
properties:
url:
type: string
description: URL de video, data URL Base64 o `mm_file://{file_id}`.
fps:
type: number
minimum: 0.2
maximum: 5
default: 1
description: Frecuencia de extracción de fotogramas
detail:
type: string
enum:
- low
- default
- high
default: default
description: Precisión del análisis
max_long_side_pixel:
type: integer
minimum: 1
description: >-
Límite de píxeles del lado más largo de los fotogramas de
video.
ReasoningContentPart:
type: object
title: Bloque de razonamiento
required:
- type
- text
properties:
type:
type: string
enum:
- reasoning_text
text:
type: string
description: Texto del razonamiento.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Todas las API requieren autenticación con Bearer Token
**Obtener la API Key:**
Visita la [página de gestión de API
Keys](https://evolink.ai/dashboard/keys) para obtener tu API Key
**Añadir al encabezado de la solicitud:**
```
Authorization: Bearer YOUR_API_KEY
```
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.