> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# StepFun

StepFun поставляется как внешний официальный плагин (`@openclaw/stepfun-provider`) с двумя идентификаторами провайдера:

* `stepfun` для стандартной конечной точки
* `stepfun-plan` для конечной точки Step Plan

> [!WARNING]
>
> Стандартный провайдер и Step Plan — **отдельные провайдеры** с разными конечными точками и префиксами ссылок на модели (`stepfun/...` и `stepfun-plan/...`). Используйте ключ для Китая с конечными точками `.com`, а глобальный ключ — с конечными точками `.ai`.

## Установка плагина

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/stepfun-provider
openclaw gateway restart
```

## Обзор регионов и конечных точек

| Конечная точка | Китай (`.com`) | Глобальная (`.ai`) |
| - | - | - |
| Стандартная | `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` |

Переменная среды для аутентификации: `STEPFUN_API_KEY`

## Встроенный каталог

Стандартный провайдер (`stepfun`):

| Ссылка на модель | Контекст | Макс. вывод | Примечания |
| - | - | - | - |
| `stepfun/step-3.5-flash` | 262,144 | 65,536 | Стандартная модель по умолчанию |
| `stepfun/step-3.7-flash` | 262,144 | 262,144 | Поддержка мультимодального ввода изображений |

Step Plan (`stepfun-plan`):

| Ссылка на модель | Контекст | Макс. вывод | Примечания |
| - | - | - | - |
| `stepfun-plan/step-3.5-flash` | 262,144 | 65,536 | Модель Step Plan по умолчанию |
| `stepfun-plan/step-3.7-flash` | 262,144 | 262,144 | Поддержка мультимодального ввода изображений |
| `stepfun-plan/step-3.5-flash-2603` | 262,144 | 65,536 | Дополнительная модель Step Plan |

## Начало работы

> [tab] Стандартный
>
> Лучше всего подходит для задач общего назначения через стандартную конечную точку StepFun.
>
> **1. Выберите регион конечной точки**
>
> | Вариант аутентификации | Конечная точка | Регион |
> | - | - | - |
> | `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1` | Международный |
> | `stepfun-standard-api-key-cn` | `https://api.stepfun.com/v1` | Китай |
>
> **2. Запустите первоначальную настройку**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-standard-api-key-intl
> ```
>
> Конечная точка для Китая:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-standard-api-key-cn
> ```
>
> **3. Неинтерактивный вариант**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-standard-api-key-intl \
>   --stepfun-api-key "$STEPFUN_API_KEY"
> ```
>
> **4. Убедитесь, что модели доступны**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list --provider stepfun
> ```
>
> Модель по умолчанию: `stepfun/step-3.5-flash`
> Альтернативная модель: `stepfun/step-3.7-flash`

> [tab] Step Plan
>
> Лучше всего подходит для конечной точки рассуждений Step Plan.
>
> **1. Выберите регион конечной точки**
>
> | Вариант аутентификации | Конечная точка | Регион |
> | - | - | - |
> | `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1` | Международный |
> | `stepfun-plan-api-key-cn` | `https://api.stepfun.com/step_plan/v1` | Китай |
>
> **2. Запустите первоначальную настройку**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-plan-api-key-intl
> ```
>
> Конечная точка для Китая:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-plan-api-key-cn
> ```
>
> **3. Неинтерактивный вариант**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice stepfun-plan-api-key-intl \
>   --stepfun-api-key "$STEPFUN_API_KEY"
> ```
>
> **4. Убедитесь, что модели доступны**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list --provider stepfun-plan
> ```
>
> Модель по умолчанию: `stepfun-plan/step-3.5-flash`
> Альтернативные модели: `stepfun-plan/step-3.7-flash`, `stepfun-plan/step-3.5-flash-2603`

Один процесс аутентификации создаёт соответствующие региону профили как для `stepfun`, так и для `stepfun-plan`, поэтому обе поверхности обнаруживаются вместе после одного запуска первоначальной настройки.

## Расширенная конфигурация

> [accordion] Полная конфигурация: стандартный провайдер
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   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,
>             compat: {
>               supportsStore: false,
>               supportsDeveloperRole: false,
>               supportsUsageInStreaming: false,
>               supportsReasoningEffort: true,
>               supportsStrictMode: false,
>               supportedReasoningEfforts: ["low", "medium", "high"],
>               maxTokensField: "max_tokens",
>               reasoningEffortMap: {
>                 off: "low",
>                 none: "low",
>                 minimal: "low",
>                 low: "low",
>                 medium: "medium",
>                 high: "high",
>                 xhigh: "high",
>                 adaptive: "high",
>                 max: "high",
>               },
>             },
>           },
>           {
>             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,
>           },
>         ],
>       },
>     },
>   },
> }
> ```

> [accordion] Полная конфигурация: провайдер Step Plan
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   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,
>             compat: {
>               supportsStore: false,
>               supportsDeveloperRole: false,
>               supportsUsageInStreaming: false,
>               supportsReasoningEffort: true,
>               supportsStrictMode: false,
>               supportedReasoningEfforts: ["low", "medium", "high"],
>               maxTokensField: "max_tokens",
>               reasoningEffortMap: {
>                 off: "low",
>                 none: "low",
>                 minimal: "low",
>                 low: "low",
>                 medium: "medium",
>                 high: "high",
>                 xhigh: "high",
>                 adaptive: "high",
>                 max: "high",
>               },
>             },
>           },
>           {
>             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,
>           },
>         ],
>       },
>     },
>   },
> }
> ```

> [accordion] Примечания
>
> * `step-3.7-flash` принимает текстовые и графические входные данные через OpenClaw. API StepFun также поддерживает видео, которое пока не является модальностью входных данных модели в OpenClaw.
> * Step 3.7 поддерживает уровни усилий рассуждения `low`, `medium` и `high`. Поскольку у модели нет режима без рассуждения, `/think off` сопоставляется с `low`.
> * `step-3.5-flash-2603` в настоящее время доступна только в `stepfun-plan`.
> * Используйте `openclaw models list` и `openclaw models set <provider/model>`, чтобы просматривать или переключать модели.

## Связанные материалы

> [card] [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Обзор всех провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полная схема конфигурации провайдеров, моделей и плагинов.

> [card] [CLI моделей](https://docs2.openclaw.ai/ru/concepts/models.md)
>
> Как выбирать и настраивать модели.

> [card] [Платформа StepFun](https://platform.stepfun.com)
>
> Управление ключами API StepFun и документация.