From 2e4c13b1022023c071c66c9f1cc06d8fb51e2c95 Mon Sep 17 00:00:00 2001 From: staccDOTsol Date: Tue, 1 Sep 2026 04:31:23 -0400 Subject: [PATCH 1/2] docs: add OpenZoo provider page --- .../model-providers/more/openzoo.mdx | 84 +++++++++++++++++++ docs/docs.json | 1 + 2 files changed, 85 insertions(+) create mode 100644 docs/customize/model-providers/more/openzoo.mdx diff --git a/docs/customize/model-providers/more/openzoo.mdx b/docs/customize/model-providers/more/openzoo.mdx new file mode 100644 index 00000000000..a4dce14824b --- /dev/null +++ b/docs/customize/model-providers/more/openzoo.mdx @@ -0,0 +1,84 @@ +--- +title: "How to Configure OpenZoo with Continue" +sidebarTitle: "OpenZoo" +--- + + + OpenZoo is an OpenAI-compatible provider with no signup: any API key value is + accepted (for example `sk-openzoo`), and usage is paid per request — by card, + or automatically via the x402 protocol from a local burner wallet. + + + + Learn more at [openzoo.fun](https://openzoo.fun) + + +## Installation + +OpenZoo runs locally and provides an OpenAI-compatible API: + +```bash +npx openzoo +``` + +This starts the gateway at `http://localhost:8402/v1`. A hosted endpoint is +also available at `https://api.openzoo.fun/v1`. + +## Configuration + + + + ```yaml title="config.yaml" + name: My Config + version: 0.0.1 + schema: v1 + + models: + - name: GLM 5.3 Flash + provider: openai + model: z-ai/glm-5.3-flash + apiBase: http://localhost:8402/v1 + apiKey: sk-openzoo + ``` + + + ```json title="config.json" + { + "models": [ + { + "title": "GLM 5.3 Flash", + "provider": "openai", + "model": "z-ai/glm-5.3-flash", + "apiBase": "http://localhost:8402/v1", + "apiKey": "sk-openzoo" + } + ] + } + ``` + + + +To use the hosted endpoint instead, set `apiBase: https://api.openzoo.fun/v1`. + +## Available Models + +List every available model id with live pricing (free, no payment): + +```bash +curl http://localhost:8402/v1/models +``` + +Model ids are provider-prefixed, for example `z-ai/glm-5.3-flash` or +`qwen/qwen3.7-flash`. SSE streaming is supported for all models. + +## Troubleshooting + +If you see connection errors, make sure OpenZoo is running: + +```bash +curl http://localhost:8402/v1/models +npx openzoo +``` + +If a request returns HTTP 402, the local wallet is unfunded — the error body +includes directions (`npx openzoo address` / `npx openzoo balance`). diff --git a/docs/docs.json b/docs/docs.json index b7a1d83f13a..932f30ad955 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -117,6 +117,7 @@ "customize/model-providers/more/moonshot", "customize/model-providers/more/nous", "customize/model-providers/more/nvidia", + "customize/model-providers/more/openzoo", "customize/model-providers/more/tensorix", "customize/model-providers/more/together", "customize/model-providers/more/xAI", From 4d94f1c26bf0522cb14904d73214af1169cd82c8 Mon Sep 17 00:00:00 2001 From: staccDOTsol Date: Wed, 2 Sep 2026 01:52:15 -0400 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20openzoo=20=E2=80=94=20local=20proxy?= =?UTF-8?q?=20is=20the=20setup=20path;=20hosted=20endpoint=20needs=20a=20s?= =?UTF-8?q?ubscription=20key?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../model-providers/more/openzoo.mdx | 21 ++++++++++++------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/docs/customize/model-providers/more/openzoo.mdx b/docs/customize/model-providers/more/openzoo.mdx index a4dce14824b..e93f535f918 100644 --- a/docs/customize/model-providers/more/openzoo.mdx +++ b/docs/customize/model-providers/more/openzoo.mdx @@ -4,9 +4,10 @@ sidebarTitle: "OpenZoo" --- - OpenZoo is an OpenAI-compatible provider with no signup: any API key value is - accepted (for example `sk-openzoo`), and usage is paid per request — by card, - or automatically via the x402 protocol from a local burner wallet. + OpenZoo is an OpenAI-compatible provider with no account: a small local proxy + (`npx openzoo`) pays for each request via the x402 protocol from a local + burner wallet. The proxy ignores the API key, so any non-empty value works + (for example `sk-openzoo`). @@ -21,8 +22,9 @@ OpenZoo runs locally and provides an OpenAI-compatible API: npx openzoo ``` -This starts the gateway at `http://localhost:8402/v1`. A hosted endpoint is -also available at `https://api.openzoo.fun/v1`. +This starts the proxy at `http://localhost:8402/v1`. `npx openzoo address` +prints its wallet — fund it with USDC on Solana or Base; `npx openzoo balance` +shows what is left. ## Configuration @@ -58,7 +60,9 @@ also available at `https://api.openzoo.fun/v1`. -To use the hosted endpoint instead, set `apiBase: https://api.openzoo.fun/v1`. +The hosted endpoint `https://api.openzoo.fun/v1` answers HTTP 402 unless the +caller pays x402 or presents an OpenZoo subscription key (`ozk_live_…`); +Continue cannot pay x402 itself, so keep `apiBase` on the local proxy. ## Available Models @@ -80,5 +84,6 @@ curl http://localhost:8402/v1/models npx openzoo ``` -If a request returns HTTP 402, the local wallet is unfunded — the error body -includes directions (`npx openzoo address` / `npx openzoo balance`). +If a request returns HTTP 402, the local wallet is unfunded — send USDC to +the address from `npx openzoo address` (`npx openzoo balance` shows what is +left).