Idioma
Español
POST

Messages (chat)

Envía mensajes y obtiene una respuesta. max_tokens es obligatorio. En modelos insignia, usa thinking para la profundidad de razonamiento; stream, system, tools coinciden con la API oficial.

Autenticación

Se admiten dos métodos de autenticación; elija uno.
x-api-keystringOptional

Pase la clave API directamente en el encabezado como cadena sin procesar (predeterminado del SDK de Anthropic).

AuthorizationstringOptional

Bearer Token compatible con OpenAI, formato: Bearer $HY_API_KEY. Elija este o x-api-key.

Headers

Especifique los siguientes encabezados al enviar solicitudes POST.
anthropic-versionstringOptional

Número de versión de la API de Anthropic, valor recomendado: 2023-06-01. El gateway lo rellena automáticamente si se omite.

Content-TypestringOptional

Generalmente application/json, la mayoría de los SDKs lo manejan automáticamente.

Solicitud

Este endpoint acepta un objeto JSON como cuerpo de la solicitud.
modelstringRequired

ID del modelo, ej. claude-sonnet-4-6, claude-opus-4-7 (según la consola)

messagesarray of objectsRequired

Roles user o assistant; el contenido puede ser texto o bloques multimodales

max_tokensintegerRequired

Máximo de tokens de salida (obligatorio)

systemstringOptional

Prompt del sistema

streambooleanOptional

Streaming SSE

thinkingobjectOptional

Extended thinking. Preferir { "type": "adaptive" } en Opus/Sonnet 4.6; o { "type": "enabled", "budget_tokens": N } (legacy; marcado para eliminación según docs).

toolsarray of objectsOptional

Definiciones de herramientas

tool_choiceobjectOptional

Selección de herramientas

temperaturenumberOptional

Los flujos de razonamiento insignia se centran en thinking; temperature tiene efecto limitado en modelos nuevos—omitir al usar extended thinking.

top_pnumberOptional

Muestreo de núcleo (opcional, según la API)

top_kintegerOptional

Muestreo Top-k (opcional)

stop_sequencesarray of stringsOptional

Secuencias de parada

Errores

Los siguientes códigos de estado HTTP pueden devolverse en caso de fallo de la solicitud API:
POST
1import Anthropic from '@anthropic-ai/sdk'
2
3const client = new Anthropic({
4 apiKey: process.env.HY_API_KEY,
5 baseURL: 'https://apiclaw.cc',
6})
7
8const message = await client.messages.create({
9 model: 'claude-opus-4-7',
10 max_tokens: 1024,
11 system: '你是一个专业的产品助手。',
12 messages: [{ role: 'user', content: '解释一下边际成本' }],
13})
14console.log(message.content[0].text)
POST

Authorization

Obtener API Key →
🔑
REQUEST
1const response = await fetch("https://apiclaw.cc/v1/messages", {
2 method: "POST",
3 headers: {
4 "Authorization": "Bearer YOUR_API_KEY",
5 "Content-Type": "application/json",
6 },
7});
8const data = await response.json();
9console.log(data);
RESPONSE

Haz clic en Send request para ver la respuesta

Response
1{
2 "id": "msg_abc123",
3 "type": "message",
4 "role": "assistant",
5 "model": "claude-opus-4-7",
6 "content": [
7 {
8 "type": "text",
9 "text": "边际成本是指每多生产一个单位产品所增加的总成本。"
10 }
11 ],
12 "stop_reason": "end_turn",
13 "stop_sequence": null,
14 "usage": {
15 "input_tokens": 25,
16 "output_tokens": 32
17 }
18}