Model provider

公開済みの agent version が動く上流 — Subako 自身のモデル、または自前の上流を使うあなたのアカウント。

Model provider は、agent version が公開先とする上流です。Workspace からは 2 種類が見えており、model-provider list はそれを type 列で区別します。

subako model-provider list

どちらも公開の仕方は同じで、provider の id を --model-provider に渡します。

Platform provider

Subako Cloud は Subako というものをひとつ提供しており、どの workspace も何も登録せず、上流のキーも持たずにそれに対して公開できます。openai_responses を話し、3 つのモデルを提供します。

このいずれかを version 設定の model に書き、provider の id を --model-provider に渡します。

{
  "system_prompt": "You are a helpful assistant.",
  "model": {
    "format": "openai_responses",
    "model": "hawk",
    "max_tokens": 8192,
    "context_window": 128000
  }
}

これらの呼び出しは organization のクレジット残高から、トークン単位で、モデルごとに異なるレートで引かれます — レートは Plan と請求にあります。Platform provider はあなたの workspace ではなくデプロイメントに属するので、更新や削除は 403 で拒否され、plan の model provider 上限にも数えられません。

自前の上流を使う

自分の上流アカウントを登録すれば、そこに直接つなげて動かせます。これらの呼び出しを Subako が課金することはありません — あなたが上流に支払います。

subako model-provider create \
  --format anthropic \
  --display-name "Anthropic production" \
  --base-url https://api.anthropic.com < key.txt

API キーはフラグではなく、必ず標準入力から読まれます。--description はより長い説明を受け取り、省略すると空です。

Format

Format は上流が話すプロトコルであって、ブランド名ではありません。このサーバーが受け付けるものは subako model-provider formats が一覧します。

これらのプロトコルのいずれかを話す上流なら何でも動きます — ホスティングされたサービス、自分で運用するゲートウェイ、互換 provider — ベース URL を選ぶのはあなただからです。

Format は一致していなければならない

Agent version は、そのモデル設定が話す format と一致する format の provider に対してのみ公開できます。anthropic の設定を openai_responses の provider に対して公開しようとすると、公開時に拒否されます。

{
  "system_prompt": "You are a helpful assistant.",
  "model": {
    "format": "openai_responses",
    "model": "your-model-id",
    "max_tokens": 8192,
    "context_window": 128000
  }
}

キーはプロキシから出ない

Run が確保されるとき、engine は モデルプロキシのバインディング を渡されます。その確保のために新しく発行された URL と run token です。モデル呼び出しはプロキシを経由し、あなたの provider キーを保持しているプロキシがそれを付与します。

Engine がキーを持つことはありません。古い試行の token は run が再確保された瞬間に効かなくなるので、再試行された run が古い試行のままあなたのアカウントで支出を続けることはできません。

削除

subako model-provider delete <model-provider-id>

これは provider を、保存された API キーごと恒久的に削除します。すでに動いている session は残りますが、それを経由するその後の呼び出しは拒否されます。ローテーションするには、新しい provider を作り、それに対して新しい agent version を公開してください。

削除できるのは、あなたの workspace が登録した provider だけです。platform のものは 403 で拒否されます。