Developer docs

Quickstart

1. Step 1

   Continue with Google

2. Step 2

   Receive trial credit if risk checks pass

3. Step 3

   Create a console sk key

4. Step 4

   Call /v1/chat/completions

curl -s "https://thesmartoken.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SMTOKEN_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "stream": false,
    "messages": [
      { "role": "user", "content": "Explain tool calling in one paragraph." }
    ]
  }'

OpenAI SDK migration

Keep your existing OpenAI SDK. Change baseURL to https://thesmartoken.com/v1, then set model to a SmarToken model ID.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_SMARTOKEN_KEY",
    base_url="https://thesmartoken.com/v1",
)

completion = client.chat.completions.create(
    model="kimi-k2",
    messages=[{"role": "user", "content": "Draft a product launch checklist."}],
)

print(completion.choices[0].message.content)

import OpenAI from "openai";

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

const completion = await client.chat.completions.create({
  model: "qwen-plus",
  messages: [{ role: "user", content: "Summarize this API design." }],
});

console.log(completion.choices[0]?.message?.content);

OpenRouter migration

For Chinese model traffic, replace the OpenRouter base URL with https://thesmartoken.com/v1 and use a SmarToken key. Common OpenRouter-style IDs such as deepseek/deepseek-chat, qwen/qwen-plus and moonshot/kimi-k2 are normalized to SmarToken routes.

import OpenAI from "openai";

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

const completion = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Review this TypeScript function." }],
});

Streaming

Set stream:true to receive OpenAI-compatible SSE chunks. Usage is written and balance is deducted after the stream finishes.

curl -N "https://thesmartoken.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SMTOKEN_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Write a short onboarding email." }
    ]
  }'

Model IDs

You can also fetch the live list from GET https://thesmartoken.com/v1/models. The API includes catalog pricing, final billable pricing and the public platform fee.

Billing and usage

SmarToken uses prepaid USD wallet balance. Each completed request records prompt tokens, completion tokens, final billable cost and provider latency; streaming requests settle after the stream finishes. Billable token rates are catalog model rates plus a transparent 20% platform fee.

Budget limits

API keys can be scoped by daily budget, monthly budget and allowed model family. Requests are blocked before provider calls when a key is revoked, outside its model scope, or over budget.

Error codes

• 400 - Unknown model, empty messages or blocked prompt.
• 401 - Missing, invalid or revoked API key.
• 402 - Insufficient balance or API key budget exceeded.
• 503 - No OpenAI-compatible upstream route is configured.