Markdown Preview

MaaS_Cl_Sonnet_5_20240620

模型概览

项	值
模型 ID（model）	claude-sonnet-5
状态	Active（Latest）；2026-06-30 发布，不早于 2027-06-30 退役
上下文长度	1M tokens（默认即最大值，无更小上下文变体）
最大输入	源文档未单独说明（上下文 1M tokens 为输入与输出合计口径）
最大输出	128K tokens（Message Batches API 在 output-300k-2026-03-24 beta 下最高 300K）
输入模态	Text、Image
输出模态	Text
思考模式	Adaptive（默认开启，请求不带 thinking 字段也会思考）
默认 effort	high
知识截止	可靠知识截止 2026-01；训练数据截止 2026-01
分词器	新分词器：同一段文本的 token 数比 Sonnet 4.6 约多 30%

请求协议

https

Header

参数名	类型	必填	描述
Content-Type	string	是	application/json
Authorization	string	是	Bearer ${your_AK}

Anthropic Messages

请求 URL

POST https://genaiapi.cloudsway.net/{endpoint}/v1/messages

Header（本协议额外）

参数名	类型	必填	描述
anthropic-version	string	是	源站要求的 API 版本号，当前为 2023-06-01

请求 Body 参数

参数名	二级参数	三级参数	类型	必填	描述
model	-	-	string	是	固定为 MaaS_Cl_Sonnet_5_20240620（厂商原始 model：claude-sonnet-5）
max_tokens	-	-	number	是	输出硬上限，含思考与正文合计（本模型默认开启思考，请按需上调该值）；模型可能提前自然停止；设为 0 可在不生成响应的情况下预热 prompt cache；最小值 0
messages	-	-	array of MessageParam	是	输入消息，单请求上限 100,000 条；连续同角色消息会被合并
	role	-	string	是	user / assistant / system
	content	-	string 或 array of ContentBlockParam	是	字符串为 [{"type":"text","text":"..."}] 的简写
		type	string	是	text / image / document / search_result / thinking / redacted_thinking / tool_use / tool_result / server_tool_use / web_search_tool_result / web_fetch_tool_result
		text	string	条件	type=text 时的文本内容（minLength 1）
		source	object	条件	type=image/document 的来源：base64（data + media_type）、url 或 file_id；图片 media_type 支持 image/jpeg/image/png/image/gif/image/webp
		id / name / input	string / string / map	条件	type=tool_use：工具调用 id、工具名（1–200 字符）、入参
		tool_use_id / content	string / string 或 array	条件	type=tool_result：对应 tool_use 的 id 与回传内容
		signature / thinking	string / string	条件	type=thinking：上一轮返回的签名与思考文本，须原样回传；改动返回 400 invalid_request_error
		data	string	条件	type=redacted_thinking 的加密内容，原样回传
		cache_control	object	否	在内容块创建缓存断点：{"type":"ephemeral","ttl":"5m"\|"1h"}，ttl 默认 5m
		citations	array	否	文本引用块（char_location / page_location / content_block_location / web_search_result_location / search_result_location）
system	-	-	string 或 array of TextBlockParam	否	系统提示词；Messages API 无 system 角色消息，系统提示走本字段
stream	-	-	boolean	否	是否以 SSE 增量返回
stop_sequences	-	-	array of string	否	自定义停止序列；命中时 stop_reason 为 stop_sequence，并在 stop_sequence 返回命中序列
tools	-	-	array of ToolUnion	否	工具定义（客户端工具：name、description、input_schema；亦可传服务端工具，如 web_search / web_fetch / code_execution / text_editor / json，以及本模型支持而 4.6 不支持的 browser use、computer_toolset_20260801）
	name	-	string	是	工具名（1–128 字符，^[a-zA-Z0-9_-]{1,128}$）
	description	-	string	否	工具说明，建议尽量详细
	input_schema	-	object	是	工具入参 JSON Schema（type: "object"、properties、required）
	cache_control / strict / defer_loading / allowed_callers / input_examples / eager_input_streaming	-	各自类型	否	缓存断点、入参强校验、延迟加载、允许的调用方、入参示例、入参流式
tool_choice	-	-	object	否	{"type":"auto"} / {"type":"any"} / {"type":"tool","name":"..."} / {"type":"none"}；各分支可带 disable_parallel_tool_use（默认 false）
thinking	-	-	object	否	本模型可用值仅 {"type":"adaptive"}（默认行为，可带 display：summarized|omitted）与 {"type":"disabled"}（关闭思考）；{"type":"enabled","budget_tokens":N} 已移除，传了返回 400
output_config	-	-	object	否	effort：low / medium / high（默认，等价于不传）/ xhigh / max；不要把 adaptive 当 effort 值。format：Structured Outputs 的 {"type":"json_schema","schema":{...}}。本模型不支持 per-message 中途改 effort（属其他型号的 beta）
metadata	-	-	object	否	user_id：外部用户标识（建议 uuid/哈希，最长 512，勿放姓名/邮箱/电话）
service_tier	-	-	string	否	auto 或 standard_only；注意本模型不支持 Priority Tier
container	-	-	object 或 string	否	容器复用标识；对象形式可带 id 与 skills（≤20 个：skill_id + type：anthropic/custom + version）
cache_control	-	-	object	否	顶层缓存控制，自动为最后一个可缓存块打缓存断点
inference_geo	-	-	string	否	推理处理地域；不传则用工作空间默认 default_inference_geo
temperature	-	-	number	否	本模型非默认值返回 400；请删除该参数，用系统提示引导风格
top_p	-	-	number	否	本模型非默认值返回 400；请删除该参数
top_k	-	-	number	否	本模型非默认值返回 400；请删除该参数

请求示例

curl -X POST 'https://genaiapi.cloudsway.net/{endpoint}/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

控制思考与档位（本模型专属口径）

# 关闭思考（默认是开启的）
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "max_tokens": 4096,
    "thinking": {"type": "disabled"},
    "messages": [{"role": "user", "content": "把下面这句话翻译成英文：今天天气不错"}]
  }'

# 提高思考深度（effort 取代了 4.6 时代的 budget_tokens）
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "max_tokens": 32768,
    "thinking": {"type": "adaptive"},
    "output_config": {"effort": "xhigh"},
    "messages": [{"role": "user", "content": "设计一个分布式限流方案并给出取舍分析"}]
  }'

响应示例

{
  "id": "msg_01AbCdEfGhIjKlMnOpQrStUv",
  "type": "message",
  "role": "assistant",
  "model": "MaaS_Cl_Sonnet_5_20240620",
  "content": [{"type": "text", "text": "你好！我是 Claude，很高兴为你提供帮助。"}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 16, "output_tokens": 28}
}

流式请求示例

curl -X POST 'https://genaiapi.cloudsway.net/{endpoint}/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "max_tokens": 4096,
    "stream": true,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

SDK 调用方式

from anthropic import Anthropic

client = Anthropic(
    api_key="${your_AK}",
    base_url="https://genaiapi.cloudsway.net/{endpoint}/v1",
)

message = client.messages.create(
    model="MaaS_Cl_Sonnet_5_20240620",
    max_tokens=4096,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(message.content[0].text)

OpenAI Chat Completions

源站说明：该协议由 Anthropic 官方 OpenAI SDK 兼容层提供，定位是"便于快速测试与比对模型能力"，不是长期/生产级方案；完整能力（PDF 处理、引用、思考过程、prompt cache）请使用原生 Messages 协议。

请求 URL

POST https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions

请求 Body 参数

参数名	二级参数	类型	必填	描述
model	-	string	是	固定为 MaaS_Cl_Sonnet_5_2024062
messages	-	array	是	对话消息；role 支持 system（或 developer，会被提升并拼接为首个系统提示）、user、assistant、tool、function
	content	string 或 array	是	user 支持 string、text、image_url(url)；image_url.detail、input_audio、file 被忽略。assistant 支持 string、text；refusal 被忽略
	tool_calls	array	否	assistant 的工具调用；function_call 同样支持
	tool_call_id	string	条件	role=tool/function 时必填
max_tokens	-	integer	否	完全支持（含思考与正文合计）
max_completion_tokens	-	integer	否	完全支持
stream	-	boolean	否	完全支持
stream_options	-	object	否	完全支持
stop	-	string 或 array	否	非空白停写序列有效
n	-	integer	否	必须为 1
tools	-	array	否	tools[n].function 的 name/description/parameters 完全支持；strict 被忽略（强校验请用原生 Structured Outputs）
functions	-	array	否	同 tools（OpenAI 已弃用该字段，建议改用 tools）
parallel_tool_calls	-	boolean	否	完全支持
thinking	-	object	否	通过兼容层扩展字段传入；本模型只接受 {"type":"adaptive"} 或 {"type":"disabled"}，传 {"type":"enabled","budget_tokens":N} 返回 400；兼容层不返回 Claude 的详细思考过程
temperature	-	number	否	兼容层文档描述为 0–1，但本模型非默认值返回 400，请删除该参数
top_p	-	number	否	兼容层文档描述为完全支持，但本模型非默认值返回 400，请删除该参数
logprobs / top_logprobs	-	-	否	被忽略
metadata	-	object	否	被忽略
response_format	-	object	否	被忽略（JSON 输出请用原生 Structured Outputs）
prediction / presence_penalty / frequency_penalty / seed / service_tier / audio / logit_bias / store / user / modalities / reasoning_effort	-	-	否	均被忽略

请求示例

curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1789000000,
  "model": "MaaS_Cl_Sonnet_5_20240620",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {"role": "assistant", "content": "你好！我是 Claude，很高兴为你解答。"}
    }
  ],
  "usage": {"prompt_tokens": 21, "completion_tokens": 19, "total_tokens": 40}
}

源站说明：兼容层 choices[] 长度恒为 1；usage.completion_tokens_details、usage.prompt_tokens_details、logprobs、service_tier、system_fingerprint、choices[].message.refusal、choices[].message.audio 恒为空。

流式请求示例

curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -d '{
    "model": "MaaS_Cl_Sonnet_5_20240620",
    "stream": true,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

SDK 调用方式

from openai import OpenAI

client = OpenAI(
    api_key="${your_AK}",
    base_url="https://genaiapi.cloudsway.net/v1/ai/{endpointPath}",
)

response = client.chat.completions.create(
    model="MaaS_Cl_Sonnet_5_20240620",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(response.choices[0].message.content)

---

三点迁移提示（源站明确，客户接入时最容易踩）：

① 请求不要再带 temperature/top_p/top_k，非默认值会 400；

② thinking 只能用 adaptive 或 disabled，老的 enabled+budget_tokens 会 400，思考深度改用 output_config.effort；

③ 新分词器使同文本 token 数约 +30%，原按 4.6 调的 max_tokens 可能截断、按 token 计的配额与成本需重新核算（另：安全拦截返回 200 + stop_reason: "refusal"，不是错误码）。

MaaS_Cl_Sonnet_4.6_20240620

模型概览

项	值
模型 ID（model）	claude-sonnet-4-6
状态	Active（Legacy）；2026-02-17 发布，不早于 2027-02-17 退役
上下文长度	1M tokens
最大输入	源文档未单独说明（上下文 1M tokens 为输入与输出合计口径）
最大输出	128K tokens（Message Batches API 在 output-300k-2026-03-24 beta 下最高 300K）
输入模态	Text、Image
输出模态	Text
思考模式	Adaptive（extended 模式已弃用）
默认 effort	high
知识截止	可靠知识截止 2025-08；训练数据截止 2026-01

请求协议

https

Header

参数名	类型	必填	描述
Content-Type	string	是	application/json
Authorization	string	是	Bearer ${your_AK}

Anthropic Messages

请求 URL

POST https://genaiapi.cloudsway.net/{endpoint}/v1/messages

Header（本协议额外）

参数名	类型	必填	描述
anthropic-version	string	是	源站要求的 API 版本号，当前为 2023-06-01

请求 Body 参数

参数名	二级参数	三级参数	类型	必填	描述
model	-	-	string	是	固定为 MaaS_Cl_Sonnet_4.6_20240620（厂商原始 model：claude-sonnet-4-6）
max_tokens	-	-	number	是	生成的最大 token 数；模型可能提前自然停止；设为 0 可在不生成响应的情况下预热 prompt cache；不同模型上限不同（最小值 0）
messages	-	-	array of MessageParam	是	输入消息，单请求上限 100,000 条；连续同角色消息会被合并；最后一条为 assistant 角色时响应将从中续写
	role	-	string	是	user / assistant / system
	content	-	string 或 array of ContentBlockParam	是	字符串为 [{"type":"text","text":"..."}] 的简写
		type	string	是	内容块类型：text / image / document / search_result / thinking / redacted_thinking / tool_use / tool_result / server_tool_use / web_search_tool_result / web_fetch_tool_result
		text	string	条件	type=text 时的文本内容（minLength 1）
		source	object	条件	type=image/document 时的来源：base64（data + media_type）、url 或 file_id；图片 media_type 支持 image/jpeg/image/png/image/gif/image/webp
		id / name / input	string / string / map	条件	type=tool_use 时：工具调用 id（^[a-zA-Z0-9_-]+$）、工具名（1–200 字符）、入参
		tool_use_id / content	string / string 或 array	条件	type=tool_result 时：对应 tool_use 的 id、回传内容（可含 text/image/search_result/document/tool_reference 等块）
		signature / thinking	string / string	条件	type=thinking 时：上一轮返回的签名与思考文本，须原样回传，改动会返回 400 invalid_request_error
		data	string	条件	type=redacted_thinking 时的加密内容，原样回传
		cache_control	object	否	在该内容块创建缓存断点：`{"type":"ephemeral","ttl":"5m"
		citations	array	否	文本引用块（char_location / page_location / content_block_location / web_search_result_location / search_result_location）
system	-	-	string 或 array of TextBlockParam	否	系统提示词；Messages API 没有 system 角色消息，系统提示走本字段
stream	-	-	boolean	否	是否以 SSE 增量返回（源站详见 streaming 文档）
stop_sequences	-	-	array of string	否	自定义停止序列；命中时响应 stop_reason 为 stop_sequence，并在 stop_sequence 字段返回命中的序列
tools	-	-	array of ToolUnion	否	工具定义（客户端工具：name、description、input_schema；亦可传服务端工具，如 web_search / web_fetch / code_execution / text_editor / json 等版本化工具类型）
	name	-	string	是	工具名（1–128 字符，^[a-zA-Z0-9_-]{1,128}$）
	description	-	string	否	工具说明，建议尽量详细
	input_schema	-	object	是	工具入参 JSON Schema（type: "object"、properties、required）
	cache_control / strict / defer_loading / allowed_callers / input_examples / eager_input_streaming	-	各自类型	否	缓存断点、入参 schema 强校验、延迟加载、允许的调用方、入参示例、入参流式
tool_choice	-	-	object	否	工具选择：{"type":"auto"}（模型自行决定）/ {"type":"any"}（必用工具）/ {"type":"tool","name":"..."}（指定工具）/ {"type":"none"}（禁用工具）；各分支可带 disable_parallel_tool_use（默认 false，true 时最多/恰好一次工具调用）
thinking	-	-	object	否	思考配置，三选一：{"type":"enabled","budget_tokens":N,"display":"summarized"\|"omitted"}（budget_tokens ≥1024 且小于 max_tokens）、{"type":"disabled"}、{"type":"adaptive","display":...}；display 默认 summarized，设为 omitted 时不返回思考内容但保留签名以便多轮续接
output_config	-	-	object	否	输出配置：effort（low/medium/high/xhigh/max）、format（Structured Outputs 的 {"type":"json_schema","schema":{...}}）
metadata	-	-	object	否	请求元数据：user_id（外部用户标识，建议 uuid/哈希，最长 512，勿放姓名/邮箱/电话）
service_tier	-	-	string	否	auto（可用时走优先容量）或 standard_only
container	-	-	object 或 string	否	容器复用标识；对象形式可带 id 与 skills（最多 20 个，skill_id + type：anthropic/custom + version）
cache_control	-	-	object	否	顶层缓存控制，自动为请求中最后一个可缓存块打缓存断点
inference_geo	-	-	string	否	推理处理地域；不传则使用工作空间默认 default_inference_geo

请求示例

curl -X POST 'https://genaiapi.cloudsway.net/{endpoint}/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "MaaS_Cl_Sonnet_4.6_20240620",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

响应示例

{
  "id": "msg_01XyZabcdEFghijklMNOpqr",
  "type": "message",
  "role": "assistant",
  "model": "MaaS_Cl_Sonnet_4.6_20240620",
  "content": [{"type": "text", "text": "你好！我是 Claude，一个由 Anthropic 训练的 AI 助手。"}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 18, "output_tokens": 32}
}

流式请求示例

curl -X POST 'https://genaiapi.cloudsway.net/{endpoint}/v1/messages' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{
    "model": "MaaS_Cl_Sonnet_4.6_20240620",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

SDK 调用方式

from anthropic import Anthropic

client = Anthropic(
    api_key="${your_AK}",
    base_url="https://genaiapi.cloudsway.net/{endpoint}/v1",
)

message = client.messages.create(
    model="MaaS_Cl_Sonnet_4.6_20240620",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(message.content[0].text)

OpenAI Chat Completions

源站说明：该协议由 Anthropic 官方 OpenAI SDK 兼容层提供，定位是"便于快速测试与比对模型能力"，不是长期/生产级方案；完整能力（PDF 处理、引用、思考过程、prompt cache）请使用原生 Messages 协议。

请求 URL

POST https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions

请求 Body 参数

参数名	二级参数	类型	必填	描述
model	-	string	是	固定为 MaaS_Cl_Sonnet_4.6_20240620（厂商原始 model：claude-sonnet-4-6）
messages	-	array	是	对话消息；role 支持 system（或 developer，会被提升并拼接为首个系统提示）、user、assistant、tool、function
	content	string 或 array	是	user 支持 string、text、image_url(url)；image_url.detail、input_audio、file 被忽略。assistant 支持 string、text；refusal 被忽略
	tool_calls	array	否	assistant 的工具调用；function_call 同样支持
	tool_call_id	string	条件	role=tool/function 时必填
max_tokens	-	integer	否	完全支持
max_completion_tokens	-	integer	否	完全支持
stream	-	boolean	否	完全支持
stream_options	-	object	否	完全支持
temperature	-	number	否	取值 0–1（含），大于 1 会被截断为 1
top_p	-	number	否	完全支持
n	-	integer	否	必须为 1
stop	-	string 或 array	否	非空白停写序列有效
tools	-	array	否	tools[n].function 的 name/description/parameters 完全支持；strict 被忽略（需强校验请用原生 Structured Outputs）
functions	-	array	否	同 tools（OpenAI 已弃用该字段，建议改用 tools）
parallel_tool_calls	-	boolean	否	完全支持
thinking	-	object	否	通过兼容层扩展字段传入：{"type":"enabled","budget_tokens":2000}；兼容层不返回 Claude 的详细思考过程
logprobs / top_logprobs	-	-	否	被忽略
metadata	-	object	否	被忽略
response_format	-	object	否	被忽略（JSON 输出请用原生 Structured Outputs）
prediction / presence_penalty / frequency_penalty / seed / service_tier / audio / logit_bias / store / user / modalities / reasoning_effort	-	-	否	均被忽略

请求示例

curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -d '{
    "model": "MaaS_Cl_Sonnet_4.6_20240620",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1789000000,
  "model": "MaaS_Cl_Sonnet_4.6_20240620",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {"role": "assistant", "content": "你好！我是 Claude，很高兴为你解答。"}
    }
  ],
  "usage": {"prompt_tokens": 20, "completion_tokens": 18, "total_tokens": 38}
}

源站说明：兼容层 choices[] 长度恒为 1；usage.completion_tokens_details、usage.prompt_tokens_details、logprobs、service_tier、system_fingerprint、choices[].message.refusal、choices[].message.audio 恒为空。

流式请求示例

curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${your_AK}' \
  -d '{
    "model": "MaaS_Cl_Sonnet_4.6_20240620",
    "stream": true,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

SDK 调用方式

from openai import OpenAI

client = OpenAI(
    api_key="${your_AK}",
    base_url="https://genaiapi.cloudsway.net/v1/ai/{endpointPath}",
)

response = client.chat.completions.create(
    model="MaaS_Cl_Sonnet_4.6_20240620",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(response.choices[0].message.content)