对话 API
对话模型按模型名调用,支持三种原生协议。所有模型都支持 OpenAI 兼容协议;Claude 模型另支持 Anthropic 协议,Gemini 模型另支持 Gemini 协议。可直接使用各协议的官方 SDK,把 Base URL 设为 https://api.get3w.com。
| 协议 | 接口 | 适用模型 |
|---|---|---|
| OpenAI | POST /v1/chat/completions | 全部对话模型 |
| Anthropic | POST /v1/messages | Claude 模型 |
| Gemini | POST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent?alt=sse | Gemini 模型 |
模型
| 提供方 | 模型 | 协议 |
|---|---|---|
| OpenAI | gpt-5.5、gpt-6-astra、gpt-6.1-sol | OpenAI |
gemini-3.1-flash-lite-preview、gemini-3.1-flash-lite、gemini-3.1-pro-preview、gemini-3.8-flash | Gemini、OpenAI | |
| Anthropic | claude-opus-4.7、claude-opus-4.6、claude-fable-5.1、claude-opus-5.5 | Anthropic、OpenAI |
| Alibaba | qwen3.7-max、qwen3.6-plus、qwen3.6-flash | OpenAI |
GET /v1/models 返回同一列表,每个模型带 protocols 数组。
OpenAI
bash
curl https://api.get3w.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "你好"}]
}'设置 "stream": true 以 Server-Sent Events 流式返回,流以 data: [DONE] 结束。
Anthropic
bash
curl https://api.get3w.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4.7",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'claude-fable-5.1 还支持 "channel": "economy"(默认)或 "official"。
Gemini
bash
curl "https://api.get3w.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"role": "user", "parts": [{"text": "你好"}]}]
}'流式调用 :streamGenerateContent?alt=sse,请求体相同。模型取自 URL。当请求由 OpenAI 兼容供应商处理时,safetySettings、cachedContent 和内置工具等 Google 专有字段会被忽略。
鉴权
三种协议都接受 Authorization: Bearer YOUR_API_KEY。Anthropic 接口另支持 x-api-key,Gemini 接口另支持 x-goog-api-key 或 ?key=。
计费
每个响应在协议自带的用量字段(usage 或 usageMetadata)旁附带 cost 对象(amount、currency)。流式响应中,cost 位于携带用量的最后一个事件。