API Reference
用一把 OptiWaves API Key 接入 Responses、Chat Completions 或 Anthropic Messages。
连接信息
| 客户端 | Base URL | 推荐模型 |
|---|---|---|
| OpenAI SDK、Codex、Pi、OpenCode | https://api.optiwaves.app/v1 | auto |
| Claude Code、Anthropic SDK | https://api.optiwaves.app | auto |
在 API Keys 创建密钥。请只在服务端或本机安全存储中使用它，不要提交到仓库。
Anthropic 客户端的 Base URL 不要带 /v1，客户端会自行拼接 /v1/messages。
认证
以 Bearer Token 传递 ow_开头的密钥：
Authorization: Bearer ow_your_api_keyAnthropic 客户端也可以使用：
x-api-key: ow_your_api_key同一请求只传一种认证头。
Responses API
POST /v1/responses 是推荐入口，支持流式输出、调用方工具与 OptiWaves 托管搜索。
curl https://api.optiwaves.app/v1/responses \
-H "Authorization: Bearer $OPTIWAVES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"input": "Search for the latest WebGPU news and cite sources."
}'Chat Completions
POST /v1/chat/completions 用于只兼容 Chat Completions 的客户端。
curl https://api.optiwaves.app/v1/chat/completions \
-H "Authorization: Bearer $OPTIWAVES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{ "role": "user", "content": "Hello" }]
}'Anthropic Messages
POST /v1/messages 用于 Claude Code 和 Anthropic SDK。
curl https://api.optiwaves.app/v1/messages \
-H "x-api-key: $OPTIWAVES_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "Hello" }]
}'端点
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /v1/models | 列出当前密钥可见的模型 |
GET | /v1/models/{id} | 查询单个模型 |
POST | /v1/responses | 推荐的 Responses 入口 |
POST | /v1/chat/completions | OpenAI Chat Completions 兼容入口 |
POST | /v1/messages | Anthropic Messages 兼容入口 |
POST | /v1/messages/count_tokens | Anthropic 输入 token 粗估 |
搜索与调用方工具
OptiWaves 会为编码助手提供托管的 web_search 和 fetch_content。当你把 tool_choice 设为 none 时，托管搜索也会关闭。
客户端声明的 bash、read、write、edit 等工具由客户端本地执行；OptiWaves 只返回工具调用，不会读写你的本机文件。
/assistant/stream 是 OptiWaves 第一方界面的内部入口，不属于对外 API。