myapikey 0.12.0 → 0.12.1

package/README.md

@@ -158,6 +158,22 @@ Quick smoke test without any tool:
 myapikey call gpt-4o-mini "Say hello in one sentence."
 ```
 
+**Why two base URLs?** The gateway exposes two separate agent surfaces — `/openai/v1` and `/anthropic/v1` — each with its own `GET /models` (an OpenAI client discovers only openai-enabled models, an Anthropic client only anthropic-enabled ones). Each ecosystem's SDK appends its own paths, so the OpenAI SDK points at `…/openai/v1` (it appends `/chat/completions`, `/responses`, `/models`) and the Anthropic SDK / Claude Code points at `…/anthropic` (it appends `/v1/messages`, `/v1/models`).
+
+**Raw HTTP** (no SDK) — hit either surface directly with the gateway API key as a `Bearer` token:
+
+```bash
+# OpenAI family
+curl http://localhost:7800/openai/v1/chat/completions \
+  -H "Authorization: Bearer <gateway api key>" -H "Content-Type: application/json" \
+  -d '{"model":"<model>","messages":[{"role":"user","content":"hi"}]}'
+
+# Anthropic family
+curl http://localhost:7800/anthropic/v1/messages \
+  -H "Authorization: Bearer <gateway api key>" -H "Content-Type: application/json" \
+  -d '{"model":"<model>","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
+```
+
 Whichever endpoint you point a tool at, the gateway forwards in that format and never translates — so make sure each model you call is backed by at least one source on the matching slot ([see below](#how-routing-works)).
 
 ---

package/README.zh-CN.md

@@ -158,6 +158,22 @@ export ANTHROPIC_API_KEY=<网关 API Key>
 myapikey call gpt-4o-mini "用一句话打个招呼。"
 ```
 
+**为什么有两个 Base URL?** 网关暴露了两个互相独立的 agent 面——`/openai/v1` 和 `/anthropic/v1`,各自带自己的 `GET /models`(OpenAI 客户端只发现 openai 槽位启用的模型,Anthropic 客户端只发现 anthropic 槽位启用的模型)。两套生态的 SDK 各自拼接自己的路径:OpenAI SDK 指向 `…/openai/v1`(它自己补 `/chat/completions`、`/responses`、`/models`),Anthropic SDK / Claude Code 指向 `…/anthropic`(它自己补 `/v1/messages`、`/v1/models`)。
+
+**直接用 HTTP**(不走 SDK)——带上网关 API Key(`Bearer`)直接打这两个面之一:
+
+```bash
+# OpenAI 系
+curl http://localhost:7800/openai/v1/chat/completions \
+  -H "Authorization: Bearer <网关 API Key>" -H "Content-Type: application/json" \
+  -d '{"model":"<模型名>","messages":[{"role":"user","content":"hi"}]}'
+
+# Anthropic 系
+curl http://localhost:7800/anthropic/v1/messages \
+  -H "Authorization: Bearer <网关 API Key>" -H "Content-Type: application/json" \
+  -d '{"model":"<模型名>","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
+```
+
 不管你把工具指向哪个端点,网关都按那个格式转发、绝不翻译——所以确保你调用的每个模型,在对应的槽位上至少有一个来源在服务它([见下文](#路由是怎么工作的))。
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myapikey",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "type": "module",
   "description": "Personal LLM API gateway & proxy — one address + one API key for all your models. Forwards OpenAI & Anthropic calls to your backends with failover and a circuit breaker. Pure passthrough, no format translation. Self-hosted (CLI + web UI).",
   "keywords": [