Saltar al contenido principal
POST
/
v1
/
messages
Crear un mensaje
curl --request POST \
  --url https://api.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'
{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}

Autorizaciones

​
Authorization
string
header
requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json
​
model
enum<string>
requerido

El modelo que completará su prompt.

Opciones disponibles:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-opus-4-5-20251101,
claude-opus-4-6,
claude-sonnet-4-6
Ejemplo:

"claude-sonnet-4-5-20250929"

​
messages
InputMessage · object[]
requerido

Mensajes de entrada.

Nuestros modelos están entrenados para operar en turnos conversacionales alternos de user y assistant. Al crear un nuevo Message, se especifican los turnos conversacionales previos con el parámetro messages, y el modelo genera el siguiente Message en la conversación. Los turnos consecutivos de user o assistant en su solicitud se combinarán en un solo turno.

Cada mensaje de entrada debe ser un objeto con role y content. Puede especificar un solo mensaje con rol user, o puede incluir múltiples mensajes de user y assistant.

​
max_tokens
integer
requerido

El número máximo de tokens a generar antes de detenerse.

Tenga en cuenta que nuestros modelos pueden detenerse antes de alcanzar este máximo. Este parámetro solo especifica el número máximo absoluto de tokens a generar.

Rango requerido: x >= 1
Ejemplo:

1024

​
container

Parámetros del contenedor con habilidades a cargar.

​
context_management
ContextManagementConfig · object

Configuración de gestión de contexto.

​
mcp_servers
RequestMCPServerURLDefinition · object[]

Servidores MCP a utilizar en esta solicitud

Maximum array length: 20
​
metadata
Metadata · object

Un objeto que describe los metadatos sobre la solicitud.

​
service_tier
enum<string>

Determina si se usa la capacidad prioritaria (si está disponible) o la capacidad estándar para esta solicitud.

Opciones disponibles:
auto,
standard_only
​
stop_sequences
string[]

Secuencias de texto personalizadas que harán que el modelo deje de generar.

​
stream
boolean

Si transmitir incrementalmente la respuesta usando eventos enviados por el servidor.

​
system

Prompt del sistema.

Ejemplo:

"Today's date is 2024-06-01."

​
temperature
number

Cantidad de aleatoriedad inyectada en la respuesta.

Por defecto es 1.0. Rango de 0.0 a 1.0.

Rango requerido: 0 <= x <= 1
Ejemplo:

1

​
thinking
Habilitar streaming SSE **Detalles**: - `true`: Devuelve resultados parciales del mensaje usando eventos enviados por el servidor - `false`: Devuelve el resultado completo de una vez (por defecto) · object

Configuración para habilitar el pensamiento extendido de Claude.

​
tool_choice
Auto · object

Cómo el modelo debe usar las herramientas proporcionadas.

​
tools
(Herramienta personalizada · object | Herramienta Bash (2024-10-22) · object | Herramienta Bash (2025-01-24) · object | Herramienta de ejecución de código (2025-05-22) · object | CodeExecutionTool_20250825 · object | Herramienta de uso de computadora (2024-01-22) · object | MemoryTool_20250818 · object | Herramienta de uso de computadora (2025-01-24) · object | Herramienta de editor de texto (2024-10-22) · object | Herramienta de editor de texto (2025-01-24) · object | Herramienta de editor de texto (2025-04-29) · object | TextEditor_20250728 · object | Herramienta de búsqueda web (2025-03-05) · object | WebFetchTool_20250910 · object)[]

Definiciones de herramientas que el modelo puede usar.

​
top_k
integer

Solo muestrear de las K opciones principales para cada token subsiguiente.

Rango requerido: x >= 0
Ejemplo:

5

​
top_p
number

Usar muestreo de núcleo.

Rango requerido: 0 <= x <= 1
Ejemplo:

0.7

Respuesta

Objeto de mensaje

​
id
string
requerido

Identificador único del objeto.

El formato y la longitud de los IDs pueden cambiar con el tiempo.

Ejemplo:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

​
type
string
requerido

Tipo de objeto.

Para Messages, esto siempre es "message".

Allowed value: "message"
​
role
string
requerido

Rol conversacional del mensaje generado.

Esto siempre será "assistant".

Allowed value: "assistant"
​
content
(Texto · object | Pensamiento · object | Contenido de razonamiento del modelo (solo disponible para modelos thinking, devuelto cuando el modelo genera proceso de pensamiento) · object | Uso de herramienta · object | Uso de herramientas del servidor · object | Resultado de herramienta de búsqueda web · object | ResponseWebFetchToolResultBlock · object | Resultado de herramienta de ejecución de código · object | ResponseBashCodeExecutionToolResultBlock · object | ResponseTextEditorCodeExecutionToolResultBlock · object | Uso de herramienta MCP · object | Resultado de herramienta MCP · object | Subida de contenedor · object)[]
requerido

Contenido generado por el modelo.

Este es un array de bloques de contenido, cada uno con un type que determina su forma.

​
model
enum<string>
requerido

El modelo que procesó la solicitud.

Opciones disponibles:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-sonnet-4-6
Ejemplo:

"claude-sonnet-4-5-20250929"

​
stop_reason
enum<string> | null
requerido

La razón por la que nos detuvimos.

Opciones disponibles:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal,
model_context_window_exceeded
​
stop_sequence
string | null
requerido

Qué secuencia de parada personalizada se generó, si alguna.

​
usage
Uso · object
requerido

Uso de facturación y límite de tasa.

​
context_management
ResponseContextManagement · object

Respuesta de gestión de contexto.

​
container
Contenedor · object

Información sobre el contenedor utilizado en esta solicitud.