Saltar al contenido

Crear un mensaje

Anthropic Messages API: el protocolo nativo de los modelos Claude, disponible también para DeepSeek, Qwen y los modelos de la región de EE. UU.; 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; los modelos DeepSeek, Qwen y de la región de EE. UU. (-us) también lo admiten, y para cualquier otro modelo manda su propia página. 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. Los modelos Claude también se pueden llamar mediante /v1/chat/completions, compatible con OpenAI, pero este endpoint es el más completo: conserva el razonamiento entre llamadas a herramientas y admite el control de la caché de prompts y los parámetros nativos de Anthropic. /v1/responses no admite modelos Claude y devuelve 404 "La plataforma actual no admite esta ruta de API".

Las respuestas sin streaming que generan un cargo devuelven el cargo real de la solicitud: los encabezados X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency y cost / cost_usd / currency en el objeto usage de nivel superior del cuerpo (los campos existentes de usage se conservan). cost_usd es el importe en USD realmente descontado del saldo; cost es el mismo cargo en CNY, y currency es siempre CNY. Las respuestas en streaming (SSE) no lo incluyen; consulta Uso en la consola. Las respuestas sin cargo, como los errores, no incluyen ninguno. Consulte API de cuenta · Cargos.

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 del grupo de la clave actual (Claude, o un modelo que admita este protocolo, como DeepSeek o Qwen); 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

Encabezados de respuesta

X-HopBase-Cost:opcionalstring

Cargo de esta solicitud en CNY (el mismo cargo que X-HopBase-Cost-USD), con hasta 6 decimales, por ejemplo 0.0816. Solo se envía cuando la solicitud genera un cargo; no se envía en respuestas en streaming (SSE). Si la generación de imágenes tarda más de unos 40 segundos, los encabezados ya se enviaron: lee usage.cost en el cuerpo

X-HopBase-Cost-USD:opcionalstring

Importe en USD realmente descontado del saldo por esta solicitud, el mismo que su registro de uso, con hasta 8 decimales, como 0.012; solo se envía junto con X-HopBase-Cost

X-HopBase-Currency:opcionalstring

Moneda de X-HopBase-Cost, siempre CNY

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

Páginas relacionadas