接口总览
查看鉴权方式、协议路径与接入边界。
Weason 的接口能力随模型和渠道而变化。选择 API 前，先确认目标模型支持哪一种请求格式。
基本连接信息
| 项目 | 值 |
|---|---|
| OpenAI 兼容 Base URL | https://weason.cn/v1 |
| Anthropic 客户端站点地址 | https://weason.cn |
| OpenAI 鉴权 | Authorization: Bearer <WEASON_API_KEY> |
| JSON 请求 | Content-Type: application/json |
所有生产请求使用 HTTPS。文档站只提供教程和公开目录，不需要你在文档中输入真实 Key。
常用端点
| 方法与路径 | 用途 | 教程 |
|---|---|---|
GET /v1/models |
读取模型目录 | 模型列表 |
POST /v1/chat/completions |
消息式对话 | Chat Completions |
POST /v1/responses |
Responses 格式，Codex 等工具常用 | Responses |
POST /v1/messages |
Anthropic Messages 格式 | Claude Messages |
POST /v1/images/generations |
支持该格式的文字生图 | 图片 API |
平台公开目录还可能显示 Gemini 原生接口或其他能力，以对应模型说明为准。本教程不把某个端点的存在等同于所有模型都支持它。
最小接入顺序
读取模型列表 → 验证一个简单文本请求 → 核对使用日志 → 加入流式输出或工具调用。迁移既有项目时，先替换 Base URL、凭证和模型 ID，再逐项验证可选参数。
兼容性范围
联网搜索、文件上传、持久化会话、推理摘要、结构化输出、图片输入及工具调用等功能，需要模型、渠道、协议和客户端共同支持。不要直接照搬某个上游服务的全部参数。
返回错误时，记录 HTTP 状态码、脱敏后的请求体和完整错误消息。具体处理见 错误排查。
仍有疑问？把问题告诉我们