Tokios API Endpoints: OpenAI & Anthropic Reference

All Tokios API requests are sent to https://api.tokios.com with your sk-tok-... key as a Bearer token. Tokios exposes the OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages surfaces, plus model listing and token counting.

Base URL

https://api.tokios.com

Try it live — test any registered model in the console Playground with no code. It runs against your signed-in session, so you don’t even need an API key to experiment.

Authentication

Every request requires these headers:

Authorization: Bearer sk-tok-YOUR_KEY
Content-Type: application/json

The model field in each request is the public deployment name you registered (e.g. gemma-tunnel), not your local model id.

Usage examples

POST/v1/chat/completionsOpenAI dialect

Common request shapes against /v1/chat/completions. Replace sk-tok-YOUR_KEY and gemma-tunnel with your own. Streaming and tool calling depend on the underlying model supporting them.

Basic
Streaming
Tool calling
Windows

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is 2 + 2?"}]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is 2 + 2?"}],
)
print(resp.choices[0].message.content)

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Write a haiku about tunnels."}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

stream = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Write a haiku about tunnels."}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "What is the weather in Paris?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-tok-YOUR_KEY", base_url="https://api.tokios.com/v1")

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

resp = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "What is the weather in Paris?"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

PowerShell reads -d @body.json from a file to avoid quote-escaping pain:

PowerShell

$body = '{"model":"gemma-tunnel","messages":[{"role":"user","content":"What is 2 + 2?"}]}'
Set-Content -Path body.json -Value $body -Encoding ascii
curl.exe https://api.tokios.com/v1/chat/completions `
  -H "Authorization: Bearer sk-tok-YOUR_KEY" `
  -H "Content-Type: application/json" `
  -d "@body.json"

POST/v1/chat/completionsOpenAI dialect

POST /v1/chat/completions

Works with supported OpenAI SDKs. Send a list of messages and receive a completion from your registered model.

Request body

string

required

The public deployment name (e.g. "gemma-tunnel").

array

required

Array of message objects. Each has a role ("system", "user", or "assistant") and content. Content may be a string or an array of content blocks (text, tool calls, images) — Tokios passes the structure through.

boolean

default:"false"

Stream the response using server-sent events.

number

Sampling temperature. Higher values produce more random output.

integer

Maximum number of tokens to generate.

Example request

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is 2 + 2?"}
    ]
  }'

Response · 200

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1717000000,
  "model": "gemma-tunnel",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "2 + 2 equals 4." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 9, "total_tokens": 33 }
}

POST/v1/messagesAnthropic dialect

POST /v1/messages

Works with supported Anthropic SDKs. Send a messages array and receive a response in Anthropic’s format. Tokios translates this to Chat Completions for your model and back.

Request body

string

required

The public deployment name.

array

required

Array of message objects with a role ("user" or "assistant") and content (a string or an array of content blocks).

integer

required

Maximum number of tokens to generate.

string

System prompt to prepend to the conversation.

boolean

default:"false"

Stream the response using server-sent events.

Example request

curl https://api.tokios.com/v1/messages \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "Async/await is a syntax for handling asynchronous operations..." }],
  "model": "gemma-tunnel",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 48 }
}

POST/v1/messages/count_tokensAnthropic dialect

POST /v1/messages/count_tokens

Works with supported Anthropic SDKs. Send the same body shape as /v1/messages and receive the input token count without running a completion.

Example request

curl https://api.tokios.com/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Explain async/await"}]
  }'

Response · 200

{ "input_tokens": 12 }

POST/v1/responsesOpenAI dialect

POST /v1/responses

Works with supported OpenAI SDKs using the newer Responses format (used by OpenAI Codex). Tokios translates it to Chat Completions for your model.

Request body

string

required

The public deployment name.

string | array

required

The input text, or an array of input items, to generate a response for.

boolean

default:"false"

Stream the response using server-sent events.

Example request

curl https://api.tokios.com/v1/responses \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "input": "Write a haiku about tunnels."
  }'

GET/v1/modelsOpenAI dialect

GET /v1/models

Lists the model deployments your API key can use. Works with supported OpenAI SDKs using the standard list shape.

Example request

curl https://api.tokios.com/v1/models \
  -H "Authorization: Bearer sk-tok-YOUR_KEY"

Response · 200

{
  "object": "list",
  "data": [
    { "id": "gemma-tunnel", "object": "model", "owned_by": "tokios" },
    { "id": "qwen-coder", "object": "model", "owned_by": "tokios" }
  ]
}

Claude Code’s model picker only lists claude* ids, so it won’t show your Tokios models. Pass the model explicitly with claude --model gemma-tunnel — see the Claude Code guide.

Error codes

HTTP status	Meaning
400	Malformed request body
401	Missing or invalid API key
403	The key isn’t allowed to use this model, or the account is suspended
404	Model deployment not found
503	Connector offline or at capacity (`connector_unavailable` / `connector_busy`)

A 503 means the connector for that deployment isn’t currently connected (or is at its concurrency cap). Start the connector and confirm it shows online in the console before retrying.

Get Started

Models

Concepts

Reference

Tokios API Endpoints: OpenAI & Anthropic Reference

Authentication

Usage examples

POST /v1/chat/completions

Request body

POST /v1/messages

Request body

POST /v1/messages/count_tokens

POST /v1/responses

Request body

GET /v1/models

Error codes

​Authentication

​Usage examples

​POST /v1/chat/completions

​Request body

​POST /v1/messages

​Request body

​POST /v1/messages/count_tokens

​POST /v1/responses

​Request body

​GET /v1/models

​Error codes

Authentication

Usage examples

POST /v1/chat/completions

Request body

POST /v1/messages

Request body

POST /v1/messages/count_tokens

POST /v1/responses

Request body

GET /v1/models

Error codes