Anthropic Messages API | 51cowork API Docs

快速答案

使用 x-api-key 和 anthropic-version；model 必须来自 /v1/models，生成前可以调用 count_tokens。

生成: POST /v1/messages
计数: POST /v1/messages/count_tokens
Header: x-api-key
流式: stream: true

生成请求

Messagesbash

curl "https://api.51cowork.com/v1/messages" \
  -H "x-api-key: <key-from-dashboard>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "<model-from-v1-models>",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

字段	规则
model	使用 /v1/models 返回 ID
max_tokens	正整数，受模型能力限制
messages	至少一条合法消息
stream	可选，返回事件流

预估输入 Token

count_tokens 只用于估算输入，不会生成模型响应。生成前使用相同 model 和 messages，避免预算计算与实际请求不一致。

Count tokensbash

curl "https://api.51cowork.com/v1/messages/count_tokens" \
  -H "x-api-key: <key-from-dashboard>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"<model-from-v1-models>","messages":[{"role":"user","content":"Hello"}]}'

兼容性边界

不要假设所有模型支持相同 content、tools 或上下文字段。
上游拒绝字段时先删除最小不必要参数，再重试。
流式请求应逐事件消费，不能等待完整 body 才转发。