SonicBit AI Model API

Your first request

Send a chat message and print the reply. The OpenAI SDKs need only the base URL and your key.

curl https://api.sonicb.it/v1/chat/completions \
  -H "Authorization: Bearer $SONICBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello! What can you do?"}]
  }'

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.sonicb.it/v1",
    api_key=os.environ["SONICBIT_API_KEY"],
)

reply = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello! What can you do?"}],
)
print(reply.choices[0].message.content)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.sonicb.it/v1",
  apiKey: process.env.SONICBIT_API_KEY,
});

const reply = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(reply.choices[0].message.content);

A system message works the usual way: put your instructions first, as {"role": "system", "content": "…"}.

Streaming

Add stream: true to receive the reply as it is written. Add stream_options: {"include_usage": true} to get the token count in the last chunk.

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Write a haiku about the sea."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

const stream = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Write a haiku about the sea." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Use it in an app

Most chat and coding apps that support an OpenAI-compatible API (a “custom provider” or “OpenAI-compatible” setting) work with your key:

• Base URL: https://api.sonicb.it/v1
• API key: your sk-sb- key
• Model: a name from the list below, for example deepseek-v4-flash

Apps set up for DeepSeek can keep the model name deepseek-chat. Apps that show a balance read it from the endpoints under Check your balance.

Models

Every model costs the same per token, streams, and supports function calling. GET /v1/models lists them.

Context is the longest prompt we have tested end to end for each model, counted in tokens (1M = one million). Very long prompts take a while before the answer starts: about 30 seconds for a million tokens on deepseek-v4-flash.

Images

Send pictures to deepseek-v4.1-flash, kimi-k2.7 or kimi-k3 as parts of a user message, next to your text.

import base64

with open("photo.jpg", "rb") as f:
    photo = base64.b64encode(f.read()).decode()

reply = client.chat.completions.create(
    model="kimi-k2.7",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What is in this picture?"},
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{photo}"}},
        ],
    }],
    max_tokens=1500,
)
print(reply.choices[0].message.content)

• An image can be a data:image/…;base64, URL (PNG, JPEG, WebP or GIF) or an https:// link.
• Up to 8 images per request, in user messages only.
• A request can be up to 4 MB, which is about 3 MB of images once encoded. Shrink large photos, or send https links instead.
• Other models answer an image with 400 unsupported_content.

Thinking models

glm-5.3, kimi-k2.7 and kimi-k3 reason before they answer. The reasoning arrives in reasoning_content, separately from the answer in content, the same way DeepSeek’s reasoning model returns it.

reply = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "Is 391 a prime number?"}],
    max_tokens=2000,
)
message = reply.choices[0].message
print("Reasoning:", message.reasoning_content)
print("Answer:", message.content)

• When streaming, the reasoning comes as delta.reasoning_content before the answer.
• Reasoning tokens count toward your usage and toward max_tokens. Give these models room, for example max_tokens of 2000 or more, or the answer can be cut short.
• You don’t need to send the reasoning back in later messages.

Function calling

Describe your functions in tools. When the model wants one, the reply carries tool_calls with the function name and its arguments as JSON text.

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]
messages = [{"role": "user", "content": "What's the weather in Kuala Lumpur?"}]

reply = client.chat.completions.create(model="deepseek-v4-flash", messages=messages, tools=tools)
call = reply.choices[0].message.tool_calls[0]
print(call.function.name, call.function.arguments)  # get_weather {"city": "Kuala Lumpur"}

# Run the function yourself, then send its result back for the final answer:
messages.append(reply.choices[0].message)
messages.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 31, "sky": "sunny"}'})
final = client.chat.completions.create(model="deepseek-v4-flash", messages=messages, tools=tools)
print(final.choices[0].message.content)

Packs & pricing

Keys run on prepaid token packs, priced in US dollars. Each request uses its prompt tokens plus the tokens it generates, reasoning included, and every model costs the same per token.

• Each pack lasts 30 days from the day you buy it. Tokens from your oldest pack are used first, and tokens left in a pack expire with it.
• Buying another pack adds its tokens to your balance and raises your limits to that pack’s, if they are higher.
• All keys on your account share one balance and one set of limits.

How to buy

Packs are sold by hand for now. Message SonicBit on Telegram or contact support with the pack you want; your key is delivered with the purchase.

Check your balance

curl https://api.sonicb.it/user/balance \
  -H "Authorization: Bearer $SONICBIT_API_KEY"

The reply has the DeepSeek balance format: balance_infos[0].total_tokens is the number of tokens you have left. Beside it, next_expiry_at (Unix time, in seconds) and next_expiry_tokens tell you when your next pack expires and how many tokens expire with it.

Apps that read OpenAI-style billing can use /v1/dashboard/billing/subscription and /v1/dashboard/billing/usage.

Errors

Errors come back in the OpenAI format, {"error": {"message": …, "type": …, "code": …}}. The code tells you what happened.

The OpenAI SDKs retry busy and temporary errors for you. A request that fails before the model starts answering is not charged.