MixerBox Cloud

文件

打造，上線。

MixerBox Cloud 完全相容 OpenAI 介面。把你的 client 指向我們的 API，30 秒就能開始發送請求。

快速上手

  1. 1. 用 MixerBox ID 登入 /dashboard。
  2. 2. 從 /dashboard 建立 API key。請當作密碼保管，不要外洩或 commit 進 repo。
  3. 3. 儲值至少 $5 (Stripe)。
  4. 4. 把 OpenAI client 的 base URL 改成 https://cloud.mixerbox.com/v1。

驗證

所有請求都需要在 Authorization header 帶 Bearer token。從 dashboard 取得你的 key。

Header 
Authorization: Bearer sk-mb-...

Chat completions

傳送訊息列表，取得模型生成的回覆。與 OpenAI /v1/chat/completions 規格完全相同。

請求

curl 
curl -X POST https://cloud.mixerbox.com/v1/chat/completions \
  -H "Authorization: Bearer sk-mb-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mixerbox/kimi-k2.5",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in one paragraph."}
    ]
  }'

回應

JSON 
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "mixerbox/kimi-k2.5",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Quantum computing harnesses..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 85,
    "total_tokens": 99
  }
}

串流

加上 "stream": true 即可接收 Server-Sent Events (SSE)。最後一個 chunk 包含 usage。

curl 
curl -X POST https://cloud.mixerbox.com/v1/chat/completions \
  -H "Authorization: Bearer sk-mb-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mixerbox/kimi-k2.5",
    "messages": [
      {"role": "user", "content": "Hello"}
    ],
    "stream": true
  }'

SSE 輸出

SSE 
data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant"},"index":0}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"Hello"},"index":0}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"!"},"index":0,"finish_reason":"stop"}],"usage":{"prompt_tokens":9,"completion_tokens":2,"total_tokens":11}}

data: [DONE]

Python

直接用官方 openai 套件。只要改 base_url。

Python 
from openai import OpenAI

client = OpenAI(
    base_url="https://cloud.mixerbox.com/v1",
    api_key="sk-mb-...",
)

response = client.chat.completions.create(
    model="mixerbox/kimi-k2.5",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js / TypeScript

直接用官方 openai 套件。只要改 baseURL。

TypeScript 
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cloud.mixerbox.com/v1",
  apiKey: "sk-mb-...",
});

const stream = await client.chat.completions.create({
  model: "mixerbox/kimi-k2.5",
  messages: [{ role: "user", content: "Hello!" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

API 文件

/v1 下開放的 endpoint:

方法 路徑 用途
POST /v1/chat/completions 聊天式生成（支援串流）
GET /v1/models 列出本服務提供的模型、價格、支援能力

可用模型

由我們 serverless 推論服務提供的模型。價格為每 1M tokens，單位 USD。

模型 ID 上下文 輸入 $/1M 輸出 $/1M
mixerbox/kimi-k2.5 256K $0.39 $1.89
mixerbox/minimax-m2.5 196K $0.14 $0.89
mixerbox/glm-5 200K $0.59 $1.91
mixerbox/glm-4.7 203K $0.39 $1.74
mixerbox/qwen3-coder 256K $0.21 $0.99
mixerbox/nemotron-30b 256K $0.04 $0.19
mixerbox/nemotron-super 256K $0.08 $0.44
mixerbox/kimi-k2-thinking 256K $0.59 $2.49
mixerbox/gemma-3-4b 128K $0.03 $0.07
mixerbox/nemotron-9b 128K $0.03 $0.15
mixerbox/nemotron-12b-vl 128K $0.17 $0.50
mixerbox/gpt-oss-safeguard 128K $0.13 $0.50

錯誤碼

標準 HTTP 狀態碼。回應遵循 OpenAI 錯誤格式。

代碼 說明
401 API key 無效或遺失。
402 餘額不足。請至 /dashboard 儲值。
404 模型不存在。查閱 /v1/models 取得可用 ID。
429 超過速率限制。請退避重試 (exponential backoff)。
500 內部錯誤。重試一次；持續發生請來信 cloud@mixerbox.com。
503 模型暫時不可用。重試或換其他模型。

SDK

不需要客製 SDK。OpenAI 官方 SDK 完全可用 — 只要覆寫 base URL。

OpenAI 相容

我們的推論服務完全實現 OpenAI 規格——所有 endpoint 形狀、欄位、錯誤碼都一致。可用來生成 client SDK、匯入 Postman / Insomnia，或餵給 AI agent，只要把 base URL 指到 https://cloud.mixerbox.com/v1。