Skip to content
Menu
Base URLhttps://api.getworg.com/v1

Quickstart

Send your first request. You need an account, a balance, and an API key.

1Create a key

Sign up in the console, top up, then open API keys and create a key. It starts with sk-worg- and is shown once. Store it in an environment variable:

Shell
export WORG_API_KEY="sk-worg-..."

2Set the base URL and a lane

Base URLhttps://api.getworg.com/v1
Modeldeepseek-v4.1-flash:cached

Any model ID from GET /v1/models works, or a combo you built: combo/<name>. See Models and compatibility.

3Send a request

cURL

curl https://api.getworg.com/v1/chat/completions \
  -H "Authorization: Bearer $WORG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash:cached",
    "messages": [{"role": "user", "content": "Say hello in Indonesian."}],
    "max_tokens": 512
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getworg.com/v1",
    api_key=os.environ["WORG_API_KEY"],
)

response = client.chat.completions.create(
    model="deepseek-v4.1-flash:cached",
    messages=[{"role": "user", "content": "Say hello in Indonesian."}],
    max_tokens=512,
)
print(response.model)
print(response.choices[0].message.content)

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.getworg.com/v1",
  apiKey: process.env.WORG_API_KEY,
});

const response = await client.chat.completions.create({
  model: "deepseek-v4.1-flash:cached",
  messages: [{ role: "user", content: "Say hello in Indonesian." }],
  max_tokens: 512,
});
console.log(response.model);
console.log(response.choices[0].message.content);

Python and TypeScript use the official OpenAI SDK with Worg's base URL. Keep max_tokens in your requests: Worg sets aside the most a request can cost before sending it, and without a cap it holds the model's whole output limit. See Rate limits.

The answer comes back in the OpenAI format. model names the lane that answered:

Response
{
  "id": "1de736c749414b5b9c43112f583c28eb",
  "object": "chat.completion",
  "created": 1793532641,
  "model": "deepseek-v4.1-flash:cached",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Halo!" },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 4,
    "total_tokens": 13,
    "prompt_tokens_details": { "cached_tokens": 0 }
  }
}

4Check the cost

Open Usage in the console. The request is listed with the lane that served it, its tokens and its cost, and the balance has gone down by that cost.

To use Worg from LiteLLM, LangChain, the Vercel AI SDK or a coding agent, see Connect clients.

Next: Platform overviewConnect clientsChat requests