Documentation
Connect your tools to a GPU Cloud deployment. Every deployment serves an OpenAI Compatible endpoint and an Anthropic-compatible Messages endpoint.
Getting started
-
1
Create an account
Sign up with your email address. Create account
-
2
Top up your wallet
Deployments are paid from a prepaid wallet in BDT. Top-ups are credited after manual verification.
-
3
Deploy a model
Choose a plan and a model. The dedicated GPUs are reserved for the term you pay for.
-
4
Copy your API key
Open the deployment page, copy the key and click Show to reveal a key later. Keys are secret: never commit them to source control.
Connect your tools
Replace <your-deployment> with the slug shown on your deployment page, <your-model-name> with its model name, and YOUR_API_KEY with your key. One endpoint can serve several models; send the name of the model you want in the model field.
| Setting | Value | Action |
|---|---|---|
| OpenAI base URL | https://models.betopiacloud.com/c/<your-deployment>/v1 | |
| Anthropic base URL | https://models.betopiacloud.com/c/<your-deployment> | |
| Model name | <your-model-name> |
Replace YOUR_API_KEY with a key from your deployment page.
Claude Code talks to the Anthropic Messages API, which your deployment serves natively.
Install
npm install -g @anthropic-ai/claude-code
macOS / Linux
export ANTHROPIC_BASE_URL="https://models.betopiacloud.com/c/<your-deployment>"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="<your-model-name>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<your-model-name>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<your-model-name>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<your-model-name>"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=65536
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://models.betopiacloud.com/c/<your-deployment>"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:ANTHROPIC_MODEL="<your-model-name>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="<your-model-name>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="<your-model-name>"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="<your-model-name>"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="65536"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude
Persistent: ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://models.betopiacloud.com/c/<your-deployment>",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "<your-model-name>",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "<your-model-name>",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "<your-model-name>",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "<your-model-name>",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "65536",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
Codex CLI uses the OpenAI Responses API, which your deployment serves under the /v1 base URL.
Install
npm install -g @openai/codex
Configuration: ~/.codex/config.toml
model = "<your-model-name>" model_provider = "betopia" [model_providers.betopia] name = "Betopia GPU Cloud" base_url = "https://models.betopiacloud.com/c/<your-deployment>/v1" env_key = "BETOPIA_API_KEY" wire_api = "responses"
Set your key (macOS / Linux)
export BETOPIA_API_KEY="YOUR_API_KEY"
Set your key (Windows PowerShell)
$env:BETOPIA_API_KEY="YOUR_API_KEY"
Then run codex.
Add this provider to opencode.json in your project root or in ~/.config/opencode/opencode.json, then select betopia/<your-model-name>.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"betopia": {
"npm": "@ai-sdk/openai-compatible",
"name": "Betopia GPU Cloud",
"options": { "baseURL": "https://models.betopiacloud.com/c/<your-deployment>/v1", "apiKey": "YOUR_API_KEY" },
"models": { "<your-model-name>": { "name": "<your-model-name>" } }
}
},
"model": "betopia/<your-model-name>"
}
Set up the Cline or Roo Code extension in VS Code with the OpenAI Compatible provider.
- 1
Open the extension settings.
- 2
Set API Provider to "OpenAI Compatible".
- 3
Set Base URL to https://models.betopiacloud.com/c/<your-deployment>/v1.
- 4
Set API Key to YOUR_API_KEY.
- 5
Set Model ID to <your-model-name>.
- 6
Set Context Window to your deployment's context size.
- 7
Save.
| API Provider | OpenAI Compatible |
|---|---|
| Base URL | https://models.betopiacloud.com/c/<your-deployment>/v1 |
| API Key | YOUR_API_KEY |
| Model ID | <your-model-name> |
| Context Window | Your deployment's context size |
Add this model to the Continue config file and reload the window.
Configuration: ~/.continue/config.yaml
name: Betopia
version: 1.0.0
schema: v1
models:
- name: <your-model-name>
provider: openai
model: <your-model-name>
apiBase: https://models.betopiacloud.com/c/<your-deployment>/v1
apiKey: YOUR_API_KEY
roles: [chat, edit, apply]
Point Cursor's OpenAI model settings at your deployment.
- 1
Open Settings and go to Models.
- 2
Paste YOUR_API_KEY into "OpenAI API Key".
- 3
Enable "Override OpenAI Base URL" and enter https://models.betopiacloud.com/c/<your-deployment>/v1.
- 4
Click "Add model", enter <your-model-name>, then click Verify.
Aider reads OpenAI-compatible settings from environment variables.
Install and run
python -m pip install aider-install && aider-install
export OPENAI_API_BASE="https://models.betopiacloud.com/c/<your-deployment>/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
aider --model openai/<your-model-name>
Add your deployment as an OpenAI connection in Open WebUI.
- 1
Open Admin Settings, then Connections, then OpenAI API.
- 2
Click "+" and enter URL https://models.betopiacloud.com/c/<your-deployment>/v1 and Key YOUR_API_KEY.
- 3
Click Save. The model <your-model-name> appears in the model picker.
Use the OpenAI Python SDK against your deployment.
Install
pip install openai
Chat and streaming
from openai import OpenAI
client = OpenAI(base_url="https://models.betopiacloud.com/c/<your-deployment>/v1", api_key="YOUR_API_KEY")
resp = client.chat.completions.create(
model="<your-model-name>",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
# Streaming
stream = client.chat.completions.create(
model="<your-model-name>",
messages=[{"role": "user", "content": "Write a haiku"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="", flush=True)
Use the OpenAI Node SDK against your deployment.
Install
npm install openai
Chat completion
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://models.betopiacloud.com/c/<your-deployment>/v1", apiKey: "YOUR_API_KEY" });
const r = await client.chat.completions.create({
model: "<your-model-name>",
messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);
Use the Anthropic Python SDK against the native Messages API of your deployment.
Install
pip install anthropic
Message
import anthropic
client = anthropic.Anthropic(base_url="https://models.betopiacloud.com/c/<your-deployment>", api_key="YOUR_API_KEY")
msg = client.messages.create(
model="<your-model-name>",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)
Use the OpenAI-compatible chat model from LangChain.
Install
pip install langchain-openai
Chat model
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(base_url="https://models.betopiacloud.com/c/<your-deployment>/v1", api_key="YOUR_API_KEY", model="<your-model-name>")
print(llm.invoke("Hello").content)
Call both endpoints directly from a terminal.
OpenAI-compatible chat completions
curl https://models.betopiacloud.com/c/<your-deployment>/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "<your-model-name>", "messages": [{"role": "user", "content": "Hello"}]}'
Anthropic-compatible Messages
curl https://models.betopiacloud.com/c/<your-deployment>/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "<your-model-name>", "max_tokens": 256, "messages": [{"role": "user", "content": "Hello"}]}'
Troubleshooting
401 Unauthorized
The key is wrong or has been revoked. Copy a current key from the deployment page, or create a new one.
503 Service Unavailable
The deployment is not running or has expired. Check its status and renew it if needed.
The first response is slow
The model is still loading onto the GPUs. Wait a moment and retry.
"context length exceeded"
The prompt is larger than the context size. Raise the context size in the Models card of your deployment page.
The agent cannot call tools
Use a tool-calling model such as Qwen3-Coder with a context size of at least 65,536 tokens.