Skip to main content
POST
Crear un mensaje
/v1/messages acepta cargas de solicitud de la API Anthropic Messages y devuelve respuestas con formato Anthropic.

Transmisión

Establece stream: true para recibir eventos enviados por el servidor en formato Anthropic (message_start, content_block_*, message_delta, message_stop).

Notas

  • Se admiten los campos de uso de herramientas de Anthropic.
  • stream: true también funciona con ciclos de herramientas. Para las herramientas de servidor administradas por Gateway, Phaseo puede materializar el turno upstream, continuar el ciclo y volver a emitir un flujo sintético.
  • El formato nativo de la herramienta de búsqueda web de Anthropic también se acepta directamente en tools, por ejemplo type: "web_search_20250305".
  • El encabezado X-Phaseo-Strictness controla cómo se gestionan los parámetros no compatibles.

Herramientas del servidor

/v1/messages también admite estas herramientas de servidor administradas por Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
Phaseo convierte estas herramientas al formato compatible con Anthropic para el proveedor upstream, las ejecuta en el servidor y continúa el ciclo de herramientas.

Búsqueda web nativa del proveedor

Cuando un par compatible de modelo y proveedor Anthropic admite búsqueda web nativa, también puedes pasar directamente esta definición de herramienta:
El enrutamiento del proveedor sigue filtrando por compatibilidad con web_search_options antes de ejecutar la solicitud.

Ejemplo de fecha y hora

Cuando se usa, los contadores usage.server_tool_use.* registran las invocaciones de herramientas del servidor.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
messages
object[]
requerido
Minimum array length: 1
max_tokens
integer
requerido
Rango requerido: x >= 1
system
service_tier
enum<string>

Selecciona un nivel de enrutamiento o precios compatible en las API de texto que lo admiten.

Opciones disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
temperature
number
Rango requerido: 0 <= x <= 1
top_p
number
Rango requerido: 0 <= x <= 1
top_k
integer
Rango requerido: x >= 1
tools
object[]

Herramientas compatibles con Anthropic y herramientas de servidor gestionadas por el gateway.

tool_choice

Objeto o cadena de selección de herramientas de Anthropic. También se aceptan los nombres de herramientas de servidor gestionadas por el gateway, que este transforma.

stream
boolean
metadata
object
session_id
string

Identificador único para agrupar solicitudes relacionadas (por ejemplo, una conversación o un flujo de trabajo de agente) y facilitar la observabilidad.

Maximum string length: 256
reasoning
object
stop_sequences
string[]
provider_options
object

Opciones específicas del proveedor, si se necesitan.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

Controles de depuración de la pasarela. Estas opciones nunca se reenvían al proveedor.

provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

Respuesta

Respuesta del mensaje

id
string
type
string
role
enum<string>
Opciones disponibles:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
Última modificación el 2 de octubre de 2026