Baseten Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Baseten

개요

이 페이지는 OpenClaw Baseten provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Baseten setup for Inkling and hosted Model APIs

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Property	Value
Provider id	baseten
Plugin	official external package (@openclaw/baseten-provider)
Auth env var	BASETEN_API_KEY
Onboarding flag	--auth-choice baseten-api-key
Direct CLI flag	--baseten-api-key <key>
API	OpenAI-compatible (openai-completions)
Base URL	https://inference.baseten.co/v1
Default model	baseten/thinkingmachines/inkling

공식 문서 기반 상세

아래는 공식 providers/baseten 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

Baseten Model APIs provide hosted, OpenAI-compatible access to frontier models. The official external plugin uses authenticated discovery, so OpenClaw follows the complete model set enabled for your Baseten account. Its offline fallback contains every Model API available when this OpenClaw release was built.

Property	Value
Provider id	baseten
Plugin	official external package (@openclaw/baseten-provider)
Auth env var	BASETEN_API_KEY
Onboarding flag	--auth-choice baseten-api-key
Direct CLI flag	--baseten-api-key <key>
API	OpenAI-compatible (openai-completions)
Base URL	https://inference.baseten.co/v1
Default model	baseten/thinkingmachines/inkling

Install plugin

openclaw plugins install @openclaw/baseten-provider
openclaw gateway restart

시작하기

Create a Baseten account and API key

Baseten's Basic plan has no monthly platform fee; Model API calls are usage-priced. Create a key in [Baseten API key settings](https://app.baseten.co/settings/api_keys) and check current rates on the [pricing page](https://www.baseten.co/pricing).

Run onboarding

openclaw onboard --auth-choice baseten-api-key

openclaw onboard --non-interactive \
  --auth-choice baseten-api-key \
  --baseten-api-key "$BASETEN_API_KEY"

export BASETEN_API_KEY=...

Verify the live catalog

```bash
openclaw models list --provider baseten
```

With usable auth, the plugin requests `GET /v1/models` and lists every model returned for the account. Without auth, it stays offline and uses the bundled fallback.

Inkling

Thinking Machines Lab's Inkling is the default model. In OpenClaw it supports text and image input, tool calling, structured tool schemas, configurable reasoning effort, a 1.048M-token context window, and up to 32k output tokens:

{
  agents: {
    defaults: {
      model: { primary: "baseten/thinkingmachines/inkling" },
    },
  },
}

Use /model baseten/thinkingmachines/inkling to switch an existing chat.

Bundled fallback catalog

The authenticated live catalog is authoritative. These rows keep setup and model selection useful before discovery succeeds:

Model ref	Input	Context	Max output
baseten/deepseek-ai/DeepSeek-V4-Pro	text	262k	262k
baseten/zai-org/GLM-4.7	text	200k	200k
baseten/zai-org/GLM-5	text	202k	202k
baseten/zai-org/GLM-5.1	text	202k	202k
baseten/zai-org/GLM-5.2	text	202k	202k
baseten/thinkingmachines/inkling	text, image	1.048M	32k
baseten/moonshotai/Kimi-K2.5	text, image	262k	262k
baseten/moonshotai/Kimi-K2.6	text, image	262k	262k
baseten/moonshotai/Kimi-K2.7-Code	text, image	262k	262k
baseten/nvidia/Nemotron-120B-A12B	text	202k	202k
baseten/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B	text	202k	202k
baseten/openai/gpt-oss-120b	text	128k	128k

All bundled models support tool calling and reasoning. OpenClaw maps its thinking levels to models with native reasoning_effort. Baseten's opt-in GLM, Kimi, and Nemotron models default to thinking off; most expose a binary off/on control, while GLM 5.2 exposes off, high, and max. OpenClaw sends these choices through Baseten's chat_template_args.enable_thinking control and, for GLM 5.2, the validated top-level reasoning_effort parameter.

Baseten can add, remove, or change Model APIs independently of OpenClaw releases. The plugin refreshes model ids, context limits, output limits, and input, cached-input, and output pricing from the authenticated API while retaining model-specific OpenClaw transport policy.

Manual config

Most setups only need the API key. To pin the provider explicitly:

{
  env: { BASETEN_API_KEY: "..." },
  agents: {
    defaults: {
      model: { primary: "baseten/thinkingmachines/inkling" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      baseten: {
        baseUrl: "https://inference.baseten.co/v1",
        apiKey: "${BASETEN_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "thinkingmachines/inkling",
            name: "Inkling",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

If the Gateway runs as a daemon (launchd, systemd, Docker), make sure BASETEN_API_KEY is available to that process. A key exported only in an interactive shell is not visible to an already-running managed service.

관련 문서

Choosing providers, model refs, and failover behavior.


Select OpenClaw reasoning effort levels.


List, inspect, and select discovered models.


Auth profiles and model-selection troubleshooting.

검증 체크리스트

• openclaw models list --provider baseten 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers