OpenAI 兼容 API
HTTP API 面向应用、agent 与 CI。将任意 OpenAI 兼容客户端指向 api.clavue.com，并使用会员 API Key。这与 imux 本地 Unix socket API 不同。
快速开始
在 账户 → API 密钥 创建 Key，然后：
export OPENAI_BASE_URL=https://api.clavue.com/v1
export OPENAI_API_KEY=$CLAVUE_TOKEN
curl -s $OPENAI_BASE_URL/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"clavue-2.1","messages":[{"role":"user","content":"Hello"}]}'
curl -s $OPENAI_BASE_URL/models \
-H "Authorization: Bearer $OPENAI_API_KEY"Python（OpenAI SDK）
与其他 OpenAI 兼容提供商相同。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_CLAVUE_TOKEN",
base_url="https://api.clavue.com/v1",
)
r = client.chat.completions.create(
model="clavue-2.1",
messages=[{"role": "user", "content": "Fix this bug and explain it."}],
)
print(r.choices[0].message.content)错误与退还
错误体含 requestId、code、stage、messageZh。响应头：x-imux-request-id、x-imux-error-code、x-imux-error-stage。上游失败并退还时不会永久扣额度。完整表见「错误与支持」。
官方 MCP
如 web_search 等托管工具通过官方 MCP 提供——不是自由闲聊。模型 id clavue-2.1-search 返回 agent 规范化搜索 JSON。