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.
/v1/messagesLos 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
Bearer sk-…; o usa x-api-key: sk-…, cualquiera de los dos
El SDK la envía automáticamente; se reenvía sin cambios, por ejemplo 2023-06-01
Activación de funciones beta; se reenvía sin cambios
Parámetros del cuerpoJSON
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
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
En el formato oficial de Anthropic; se reenvía sin cambios
Elementos≥ 1
user o assistant
Una cadena o un array de bloques de contenido (text, image, tool_use, tool_result, etc.)
Prompt de sistema; se reenvía sin cambios
true devuelve el flujo de eventos SSE de Anthropic
Predeterminadofalse
Definiciones de herramientas de Anthropic (name, description, input_schema); se reenvían sin cambios
Configuración de razonamiento extendido; se reenvía sin cambios, con los valores de la especificación oficial de Anthropic
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
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
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
Moneda de X-HopBase-Cost, siempre CNY
ID del mensaje
ID del modelo
Bloques de contenido
text / thinking / tool_use
Texto del bloque text
tool_use: nombre de la herramienta
tool_use: argumentos de la herramienta
end_turn / max_tokens / tool_use / stop_sequence
Uso de tokens
Tokens de entrada
Tokens de salida
Tokens de entrada escritos en caché
Tokens de entrada leídos de caché
Añadido por la pasarela: el cargo de esta solicitud en CNY (el mismo cargo que cost_usd), igual que el encabezado X-HopBase-Cost; no se devuelve en streaming
Añadido por la pasarela: el importe en USD realmente descontado del saldo, igual que el encabezado X-HopBase-Cost-USD y el registro de uso; no se devuelve en streaming
Añadido por la pasarela: la moneda de cost, siempre CNY
Errores
{"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 OpenAImissing_api_key / invalid_api_key / api_key_expired)insufficient_quota)model_not_found) o la ruta no pertenece a ese grupo (route_not_found)request_too_large)user_concurrency_limit / apikey_concurrency_limit), con Retry-After