N·00Developer Docs
Integration docs
XylemNode puts models from many providers behind one API host: the OpenAI-compatible format reaches all of them, and tools like Claude Code and Gemini CLI can use their own native protocols. Once you have a key, almost any client that lets you set a custom endpoint can connect — give it the address, key and model name, and the gateway handles routing and protocol conversion.
One entry point to every model
There's no need to wire up each vendor separately. Your tool sends its usual request, the gateway spots the target model, translates the protocol and hands the result back in the format your tool asked in — your code barely changes.
The same key works across editors, CLIs and chat clients. Usage, balance and call history all roll up to one account, so budgeting and debugging happen in a single place.
How to choose an AI API relayFirst call in three steps
From key in hand to first response usually takes a few minutes.
- 01
Fund your account
Register, buy a monthly plan or top up, and confirm you have credits available.
- 02
Create a key
On the API keys page, make a key, name it for its purpose and pick a model group: the group decides which models the key can call, so the models you want have to be in it.
- 03
Drop it into your client
Paste the address and key into your tool, pick a model and send a test message. SDKs and most tools take the address with /v1; Claude Code and Gemini CLI use their native protocols and Cherry Studio adds the path itself, so those stop at the domain. Each tool's guide has the exact form.
Reference
- OpenAI format
https://api.xylemnode.com/v1- Native protocols
https://api.xylemnode.com- API Key
sk-your-key- Model
gpt-6.1-sol
Setup steps, tool by tool
- Calling the APICall the models from your own code, with no client in between, over either of OpenAI's two protocols: the recommended Responses API, or Chat Completions, the older protocol nearly everything supports. Both live at https://api.xylemnode.com/v1, and one key works for both (a few groups are Responses-only, as their names say).→
- Image APIThere are two ways to make images. The Images API renders straight from a description (/v1/images/generations) or edits a picture you already have (/v1/images/edits); the Responses endpoint lets a chat model call image generation as a tool, which suits revising over several turns. Same address as a text call, https://api.xylemnode.com/v1, so there's no separate image service to wire up; for the Images API, use a key whose group includes the image models.→
CodexOpenAI's coding agent, used from the command line, the ChatGPT desktop app or an editor extension. All three share one config, so connecting XylemNode once covers them all.→Claude CodeAnthropic's coding assistant, used from the command line, the VS Code extension or the Claude desktop app, speaking the native Anthropic protocol; point it at XylemNode and it calls Claude models with your XylemNode key.→
Gemini CLIGoogle's command-line AI agent, speaking the native Gemini protocol; set a few environment variables to route requests to XylemNode.→
OpenCodeAn open-source AI coding agent with a desktop app and a command line, both reading the same opencode.json; connect XylemNode in the OpenAI-compatible format.→CursorAn AI-native code editor with built-in support for OpenAI-compatible services; enter the address and key to swap the default model for XylemNode's.→
OpenClawA self-hosted AI gateway that connects chat entry points like Telegram, Discord and Slack to a coding agent; the model source is customizable — just set it to XylemNode.→
CC SwitchA desktop app that centrally manages provider configs for tools like Claude Code, Codex, Gemini CLI and OpenCode: add or remove visually and switch in one click, sparing you manual edits to each tool's config.→
ClineAn open-source AI coding agent in VS Code that reads and writes across files and runs commands. It natively supports OpenAI-compatible providers — one base URL and key connects it to XylemNode.→
ContinueAn open-source AI coding assistant for VS Code and JetBrains — chat, autocomplete and edit in one. It manages models with a single config.yaml; set provider to openai and change apiBase to connect XylemNode.→
AiderAn open-source AI pair-programming tool in your terminal that edits code in your local git repo and commits automatically. Via LiteLLM it supports OpenAI-compatible endpoints — set the env vars and prefix the model name with openai/ to use XylemNode.→SillyTavernA locally self-hosted chat frontend focused on role-play and multi-turn conversation. It doesn't run models itself — it connects to a backend; choose the Custom (OpenAI-compatible) source under Chat Completion, enter the address and key, and you're on XylemNode.→
Open WebUIA self-hosted, ChatGPT-style web interface for multiple users that centrally manages several model connections. It talks to backends over the OpenAI protocol — just add XylemNode as an OpenAI connection.→- DifyAn open-source platform for building LLM apps with visual orchestration of agents, workflows and RAG. Through its OpenAI-API-compatible provider it connects any OpenAI-compatible service — enter the address and key to use XylemNode as a model source.→
- Coze Studio (open-source)The open-source, self-hosted edition of Coze for visually building AI agents and workflows. Its model service supports 'third-party API relay' — choose the openai protocol and enter a /v1 address to connect XylemNode.→
- Cherry StudioA cross-platform, open-source desktop AI client (Windows / macOS / Linux) that gathers many models in one interface. Add a custom provider of the OpenAI type to bring XylemNode in.→
- Qwen CodeTongyi's terminal AI coding agent (a Gemini CLI fork) aimed at code understanding and automation. It supports the OpenAI-compatible protocol — set the env vars to use XylemNode.→
- work-buddyA local-first agent runtime for knowledge workers, built on Claude Code and MCP, that gathers scattered journal entries, tasks, projects, calendar events and browser tabs into reusable multi-step workflows. It never talks to a model directly — every request goes out through Claude Code, so pointing Claude Code at XylemNode routes all of its workflows the same way.→
Common questions
How does XylemNode relate to what people call an API relay?
Same thing, different name. AI API relays, API proxies and LLM gateways, as the community calls them, all describe the same layer between your tools and the model vendors: you integrate against one address, and it forwards requests upstream to OpenAI, Anthropic, Google and others while smoothing over the differences between their protocols. XylemNode is that layer — we call it a gateway throughout these docs.
Configured everything but calls still fail?
Check three things in order: whether the endpoint matches the tool's requirements, whether the key was entered correctly with no missing characters, and whether the model name matches the console. Most tools need a restart (or a fresh terminal) after config changes.
Does the endpoint need /v1 or not?
It depends on the tool's protocol. OpenAI-compatible ones (Codex, Cursor, OpenCode, Cline, Continue and such) usually need /v1; Claude Code (and work-buddy, which runs on it) and Gemini CLI use their own native protocols and skip /v1; Cherry Studio and CC Switch's Universal Provider take only the domain and complete the path themselves. Each tool guide notes the right form.
Getting model not found?
The model name isn't one your key can use: either it's mistyped, or it isn't in your key's group. Go by the console's available list, mind the casing and the full identifier (version numbers, prefixes and such), and don't use abbreviations.
Getting 401 / auth failures?
It's almost always the key: mistyped, copied with a stray space, expired, or — when set via env vars — not applied because the terminal wasn't reopened. Recheck the key, and check in the console that it is still enabled and hasn't expired.
Getting a 404, or a response that can't be parsed?
Usually the address is at the wrong depth, and the two mistakes look different: leave out /v1 where it's needed and the request lands on the website, so a whole web page comes back and the client can't parse it (Unexpected token '<' and the like); add an extra segment (such as /v1/v1) and you get 404 Invalid URL. Match the tool's guide to enter the address at the right level, and don't manually tack on suffixes like /chat/completions — most tools add them automatically.
Do I need to reconfigure when switching models?
The endpoint stays the same — just change the model name to the one you want, as long as it's in your key's group; if it isn't, use a key from the group that has it. A few tools also need the new model added to their own model list first: an entry under models in the config file for OpenCode and OpenClaw, another model added in Dify and Coze Studio; and keep the openai/ prefix in aider.
How do I know which models are available?
Go by the available-models list in the console, which shows the groups each model is in; a key's group decides which models it can call. Tools that support /v1/models can also fetch the models your key can use automatically. Entering the full identifier from the list is the safest.
Can one key be used across multiple tools and devices?
Yes. The key isn't tied to any tool — you can share one key across multiple clients and machines, and credits are deducted from the same account.
How are credits and charges calculated?
Top-ups land 1:1 — top up 100 and you get 100 credits — and a plan's credits arrive in full when you activate it and can be used during its one-month term. Both sit in one account and credits are deducted by actual usage. If a call fails, first check whether the balance is sufficient and whether the model is in your key's group.
Timeouts or slow responses?
First confirm your machine can reach api.xylemnode.com normally; corporate networks, firewalls or proxies sometimes block or slow requests. If it's still slow after ruling out the network, try another model or retry later.
Didn't find your answer? Join the official QQ group, where support and other users can help you pin down the issue faster.
QQ group1103463792