StepFun Provider

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

개요

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

공식 요약: Use StepFun models with OpenClaw

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

빠른 참조

Endpoint	China (.com)	Global (.ai)
Standard	https://api.stepfun.com/v1	https://api.stepfun.ai/v1
Step Plan	https://api.stepfun.com/step_plan/v1	https://api.stepfun.ai/step_plan/v1

공식 문서 기반 상세

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

StepFun ships as an external official plugin (@openclaw/stepfun-provider) with two provider ids:

• stepfun for the standard endpoint
• stepfun-plan for the Step Plan endpoint

Standard and Step Plan are separate providers with different endpoints and model ref prefixes (stepfun/... vs stepfun-plan/...). Use a China key with the .com endpoints and a global key with the .ai endpoints.

Install plugin

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

Region and endpoint overview

Endpoint	China (.com)	Global (.ai)
Standard	https://api.stepfun.com/v1	https://api.stepfun.ai/v1
Step Plan	https://api.stepfun.com/step_plan/v1	https://api.stepfun.ai/step_plan/v1

Auth env var: STEPFUN_API_KEY

Built-in catalog

Standard (stepfun):

Model ref	Context	Max output	Notes
stepfun/step-3.5-flash	262,144	65,536	Default standard model
stepfun/step-3.7-flash	262,144	262,144	Multimodal image input support

Step Plan (stepfun-plan):

Model ref	Context	Max output	Notes
stepfun-plan/step-3.5-flash	262,144	65,536	Default Step Plan model
stepfun-plan/step-3.7-flash	262,144	262,144	Multimodal image input support
stepfun-plan/step-3.5-flash-2603	262,144	65,536	Additional Step Plan model

시작하기

Best for general-purpose use via the standard StepFun endpoint.


  

Choose your endpoint region

    | Auth choice                    | Endpoint                     | Region        |
    | -------------------------------- | ----------------------------- | -------------- |
    | `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1`  | International |
    | `stepfun-standard-api-key-cn`   | `https://api.stepfun.com/v1` | China          |
  

  

Run onboarding

    ```bash
    openclaw onboard --auth-choice stepfun-standard-api-key-intl
    ```

    China endpoint:

    ```bash
    openclaw onboard --auth-choice stepfun-standard-api-key-cn
    ```
  

  

Non-interactive alternative

    ```bash
    openclaw onboard --auth-choice stepfun-standard-api-key-intl \
      --stepfun-api-key "$STEPFUN_API_KEY"
    ```
  

  

Verify models are available

    ```bash
    openclaw models list --provider stepfun
    ```
  



Default model: `stepfun/step-3.5-flash`
Alternate model: `stepfun/step-3.7-flash`




Best for the Step Plan reasoning endpoint.


  

Choose your endpoint region

    | Auth choice                 | Endpoint                                | Region        |
    | ------------------------------ | ------------------------------------------ | -------------- |
    | `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1`  | International |
    | `stepfun-plan-api-key-cn`   | `https://api.stepfun.com/step_plan/v1` | China          |
  

  

Run onboarding

    ```bash
    openclaw onboard --auth-choice stepfun-plan-api-key-intl
    ```

    China endpoint:

    ```bash
    openclaw onboard --auth-choice stepfun-plan-api-key-cn
    ```
  

  

Non-interactive alternative

    ```bash
    openclaw onboard --auth-choice stepfun-plan-api-key-intl \
      --stepfun-api-key "$STEPFUN_API_KEY"
    ```
  

  

Verify models are available

    ```bash
    openclaw models list --provider stepfun-plan
    ```
  



Default model: `stepfun-plan/step-3.5-flash`
Alternate models: `stepfun-plan/step-3.7-flash`, `stepfun-plan/step-3.5-flash-2603`

A single auth flow writes region-matched profiles for both stepfun and stepfun-plan, so both surfaces are discovered together after one onboarding run.

고급 설정

Full config: Standard provider

```json5
{
  env: { STEPFUN_API_KEY: "your-key" },
  agents: { defaults: { model: { primary: "stepfun/step-3.5-flash" } } },
  models: {
    mode: "merge",
    providers: {
      stepfun: {
        baseUrl: "https://api.stepfun.ai/v1",
        api: "openai-completions",
        apiKey: "${STEPFUN_API_KEY}",
        models: [
          {
            id: "step-3.7-flash",
            name: "Step 3.7 Flash",
            reasoning: true,
            input: ["text", "image"],
            thinkingLevelMap: { off: "low", minimal: "low", xhigh: "high", max: "high" },
            cost: { input: 0.2, output: 1.15, cacheRead: 0.04, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "step-3.5-flash",
            name: "Step 3.5 Flash",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}
```

Full config: Step Plan provider

```json5
{
  env: { STEPFUN_API_KEY: "your-key" },
  agents: { defaults: { model: { primary: "stepfun-plan/step-3.5-flash" } } },
  models: {
    mode: "merge",
    providers: {
      "stepfun-plan": {
        baseUrl: "https://api.stepfun.ai/step_plan/v1",
        api: "openai-completions",
        apiKey: "${STEPFUN_API_KEY}",
        models: [
          {
            id: "step-3.7-flash",
            name: "Step 3.7 Flash",
            reasoning: true,
            input: ["text", "image"],
            thinkingLevelMap: { off: "low", minimal: "low", xhigh: "high", max: "high" },
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "step-3.5-flash",
            name: "Step 3.5 Flash",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 65536,
          },
          {
            id: "step-3.5-flash-2603",
            name: "Step 3.5 Flash 2603",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}
```

참고

- `step-3.7-flash` accepts text and image input through OpenClaw. StepFun's API also supports video, which is not yet a model input modality in OpenClaw.
- Step 3.7 supports `low`, `medium`, and `high` reasoning effort. Because the model has no non-reasoning mode, `/think off` maps to `low`.
- `step-3.5-flash-2603` is currently exposed only on `stepfun-plan`.
- Use `openclaw models list` and `openclaw models set <provider/model>` to inspect or switch models.

관련 문서

Overview of all providers, model refs, and failover behavior.


Full config schema for providers, models, and plugins.


How to choose and configure models.


StepFun API key management and documentation.

검증 체크리스트

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

관련

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