Presets

（モデル + システムプロンプト + パラメータ）のまとまりを一度保存し、model:"@preset/<slug>" で呼び出します。

プリセットは、よく使う設定のまとまりです — 特定の model、システムプロンプト、サンプリングパラメータを 1 つの slug に保存しておきます。通常のチャット呼び出しでは "model": "@preset/<slug>" を指定するだけでその設定一式を再利用できます。プリセットはアカウントに紐づき、発行した plm_ キーで呼び出します。

プリセットの管理#

POST/v1/presets

プリセット管理エンドポイントは、ダッシュボードのセッショントークン（ログイン済みの JWT）で認証します — Authorization: Bearer <JWT>。これらは SDK 互換のエンドポイントではなく、ダッシュボード管理用 API です。一覧は GET /v1/presets、更新は PATCH /v1/presets/{id}、削除は DELETE /v1/presets/{id} を使います。

パラメータ	型	必須	説明
slug	string	必須	呼び出し用の識別子。パターン `^[a-z0-9][a-z0-9-]{0,62}$`。`"@preset/<slug>"` として使われます。
display_name	string	必須	表示名。1〜100 文字。
description	string	任意	任意。最大 500 文字。
system_prompt	string	任意	任意。システムメッセージとして先頭に追加されます。
model	string	必須	プリセットがルーティングするモデル ID。
params	object	任意	任意。`temperature`・`max_tokens`・`top_p`・`frequency_penalty`・`presence_penalty` のみ保持され、その他のキーは破棄されます。

POST /v1/presets は成功時に 201 を返します。同じ slug のプリセットがすでに存在する場合は 409 を返します。

create preset

curl https://apirouter.pleum.ai/v1/presets \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "terse-coder",
    "display_name": "Terse Coder",
    "description": "Short, code-only answers.",
    "system_prompt": "You are a terse coding assistant. Reply with code and minimal prose.",
    "model": "claude-sonnet-4-6",
    "params": {
      "temperature": 0.2,
      "max_tokens": 2048
    }
  }'

プリセットの使用#

通常のチャット呼び出しで "model": "@preset/<slug>" を指定します。 OpenAI SDK と plm_ キーのまま動作し、プリセットのモデル・システムプロンプト・パラメータが適用されます。

use preset

curl https://apirouter.pleum.ai/v1/chat/completions \
  -H "Authorization: Bearer plm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "@preset/terse-coder",
    "messages": [
      {"role": "user", "content": "Reverse a linked list in Python."}
    ]
  }'

リクエストで明示的に指定したパラメータは、プリセットの値を上書きします — 例えばリクエストボディに temperature を直接入れると、プリセットの値より優先されます。slug はユーザーごとに一意で（重複時は 409）、存在しない slug を呼び出すと 400 が返されます。