Crear un mensaje

Anthropic Messages API: exclusiva de los modelos Claude; el Base URL no lleva /v1 y funciona directamente con el SDK de Anthropic y Claude Code.

POST/v1/messages

Los modelos Claude usan el protocolo de Anthropic. En el SDK, el Base URL es https://api.hop-base.com (sin /v1) y la ruta de la solicitud sigue siendo /v1/messages; también se admite POST /v1/messages/count_tokens.

La tabla solo incluye lo que el gateway completa o trata de forma especial; los demás campos de la Messages API se reenvían sin cambios, con los rangos de la especificación oficial de Anthropic. Una clave Claude en una ruta del protocolo OpenAI devuelve 404 "The current platform does not support this API path".

Crear un mensaje

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: $HOPBASE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hola"
      }
    ]
  }'

200application/json

{
  "id": "msg_EXAMPLE",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [
    {
      "type": "text",
      "text": "¡Hola! ¿En qué puedo ayudarte?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 9,
    "output_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Encabezados

Authorization:opcionalstring

Bearer sk-…; o usa x-api-key: sk-…, cualquiera de los dos

anthropic-version:opcionalstring

El SDK la envía automáticamente; se reenvía sin cambios, por ejemplo 2023-06-01

anthropic-beta:opcionalstring

Activación de funciones beta; se reenvía sin cambios

Parámetros del cuerpoJSON

model:obligatoriostring

Un ID de modelo Claude del grupo de la clave actual; si el grupo no incluye el modelo, devuelve 404 model_not_found

max_tokens:opcionalinteger

El gateway no fija un límite; el máximo sigue la especificación oficial del modelo. La API oficial lo exige; si falta, HopBase lo completa con 4096: las salidas largas se cortan en 4096 (stop_reason: "max_tokens"), así que indíquelo explícitamente

Predeterminado4096

messages:obligatorioarray of object

En el formato oficial de Anthropic; se reenvía sin cambios

Elementos≥ 1

system:opcionalstring o array

Prompt de sistema; se reenvía sin cambios

stream:opcionalboolean

true devuelve el flujo de eventos SSE de Anthropic

Predeterminadofalse

tools:opcionalarray of object

Definiciones de herramientas de Anthropic (name, description, input_schema); se reenvían sin cambios

thinking:opcionalobject

Configuración de razonamiento extendido; se reenvía sin cambios, con los valores de la especificación oficial de Anthropic

temperature:opcionalnumber

Se reenvía sin cambios, con el rango de la especificación oficial de Anthropic

Respuesta

200Éxito. Sin streaming es un JSON message; con stream: true es SSE de Anthropic

id:opcionalstring

ID del mensaje

type:opcional"message"

role:opcional"assistant"

model:opcionalstring

ID del modelo

content:opcionalarray of object

Bloques de contenido

stop_reason:opcionalstring

end_turn / max_tokens / tool_use / stop_sequence

usage:opcionalobject

Uso de tokens

Errores

400Estructura de Anthropic: {"type":"error","error":{"type":"invalid_request_error","message":"…"}}, sin code. Los errores de la validación de la clave (401, 402, 403) siguen teniendo estructura OpenAI

401Falta la clave, la clave no es válida o ha caducado (missing_api_key / invalid_api_key / api_key_expired)

402Se agotó el saldo o la cuota de la clave, del miembro o del departamento (insufficient_quota)

404El modelo no está en el grupo de esta clave (model_not_found) o la ruta no pertenece a ese grupo (route_not_found)

413El cuerpo de la solicitud supera 60 MB (request_too_large)

429Se alcanzó el límite de concurrencia de la cuenta o de la clave (user_concurrency_limit / apikey_concurrency_limit), con Retry-After

Encabezados

Parámetros del cuerpoJSON

Respuesta

Errores

Páginas relacionadas