MixerBox Cloud

ドキュメント

作って、出荷。

MixerBox Cloud は OpenAI 互換。クライアントの向き先を当社の推論エンドポイントに変えるだけ — 30秒で出荷。

クイックスタート

  1. 1. MixerBox ID で /dashboard にログイン。
  2. 2. /dashboard で API キーを作成。パスワード同様に管理してください（共有・コミット禁止）。
  3. 3. $5以上をチャージ (Stripe)。
  4. 4. OpenAI クライアントの base URL を https://cloud.mixerbox.com/v1 に変更。

認証

全リクエストに Authorization ヘッダーで Bearer トークンが必要です。ダッシュボードからキーを取得。

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 配下で公開されているエンドポイント:

メソッド パス 用途
POST /v1/chat/completions チャット形式生成の推論エンドポイント（ストリーミング対応）
GET /v1/models 本サービスで提供するモデル一覧、料金、機能

利用可能モデル

当社のサーバーレス推論で提供するモデル。価格は 1M トークンあたり、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キーが無効または未指定。
402 残高不足。/dashboard でチャージしてください。
404 モデルが見つかりません。/v1/models で利用可能なIDを確認。
429 レート制限超過。指数バックオフでリトライしてください。
500 内部エラー。1回リトライし、続く場合は cloud@mixerbox.com まで連絡。
503 モデルが一時的に利用不可。リトライまたは別モデルを使用。

SDK

カスタム SDK 不要。OpenAI公式ライブラリがそのまま動作します — base URL を上書きするだけ。

OpenAI 互換

当社の推論サービスは OpenAI 仕様を完全に実装 — エンドポイント形状、フィールド、エラーコードは全て一致。クライアント SDK の生成、Postman / Insomnia へのインポート、AI エージェントへの入力に利用可能。base URL を https://cloud.mixerbox.com/v1 に向けるだけ。