diff --git a/docs/customize/model-providers/more/openzoo.mdx b/docs/customize/model-providers/more/openzoo.mdx new file mode 100644 index 00000000000..e93f535f918 --- /dev/null +++ b/docs/customize/model-providers/more/openzoo.mdx @@ -0,0 +1,89 @@ +--- +title: "How to Configure OpenZoo with Continue" +sidebarTitle: "OpenZoo" +--- + + + 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`). + + + + Learn more at [openzoo.fun](https://openzoo.fun) + + +## Installation + +OpenZoo runs locally and provides an OpenAI-compatible API: + +```bash +npx openzoo +``` + +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 + + + + ```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" + } + ] + } + ``` + + + +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 + +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 — send USDC to +the address from `npx openzoo address` (`npx openzoo balance` shows what is +left). 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",