Tạo tin nhắn Claude

Yêu cầu theo định dạng Anthropic Claude Messages API. Phải bao gồm anthropic-version trong Header của yêu cầu.

POST /v1/messages

URL gốc của dịch vụ: https://api.getrouter.ai

Giao thức: Anthropic Messages

Xác thực: x-api-key: YOUR_API_KEY

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
anthropic-versionheaderstringCóPhiên bản API Anthropic
x-api-keyheaderstringKhôngKhóa API Anthropic (không bắt buộc, cũng có thể dùng Bearer Token)

Nội dung yêu cầu

Nội dung yêu cầu là tùy chọn. Loại nội dung: application/json

Trường yêu cầu

TrườngKiểuBắt buộcMô tả
modelstringCó—
messagesarray<object>Có—
systemstring or array<object>Không—
cache_controlobjectKhông—
inference_geostringKhông—
max_tokensintegerCóKhoảng giá trị: 1–∞
temperaturenumberKhôngKhoảng giá trị: 0–1
top_pnumberKhông—
top_kintegerKhông—
streambooleanKhông—
stop_sequencesarray<string>Không—
toolsarray<object>Không—
tool_choiceobjectKhông—
thinkingobjectKhông—
context_managementobjectKhông—
output_configobjectKhông—
output_formatobjectKhông—
containerstring or objectKhông—
mcp_serversarray<object>Không—
metadataobjectKhông—
speedstringKhôngGiá trị cho phép: standard, fast
service_tierstringKhôngGiá trị cho phép: auto, standard_only

Ví dụ yêu cầu

curl --request POST \
  --url https://api.getrouter.ai/v1/messages \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Xin chào, hãy giới thiệu về bạn."
    }
  ],
  "max_tokens": 1,
  "stream": false,
  "temperature": 0
}'

Phản hồi

Trạng tháiMô tả
200Tạo phản hồi thành công

Các trường của phản hồi thành công

TrườngKiểuBắt buộcMô tả
idstringKhông—
typestringKhông—
rolestringKhông—
contentarray<object>Không—
modelstringKhông—
stop_reasonstringKhôngGiá trị cho phép: end_turn, max_tokens, stop_sequence, tool_use
usageobjectKhông—

Ví dụ phản hồi

{
  "id": "string",
  "type": "string",
  "role": "user",
  "content": [
    {
      "type": "string",
      "text": "string"
    }
  ],
  "model": "MODEL_ID",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_creation_input_tokens": 1,
    "cache_read_input_tokens": 1
  }
}

Hướng dẫn liên quan

Để xem quy trình và ví dụ đầy đủ, hãy đọc hướng dẫn API Claude Messages.


Trang này được tạo từ đặc tả OpenAPI công khai của Relay. Xem đặc tả đầy đủ trong API Explorer.