StepFun

O StepFun é distribuído como um plugin oficial externo (@openclaw/stepfun-provider) com dois IDs de provedor:

stepfun para o endpoint padrão
stepfun-plan para o endpoint Step Plan

Padrão e Step Plan são provedores separados, com endpoints e prefixos de referência de modelo diferentes (stepfun/... em comparação com stepfun-plan/...). Use uma chave da China com os endpoints .com e uma chave global com os endpoints .ai.

Instalar o plugin

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

Visão geral das regiões e dos endpoints

Endpoint	China (`.com`)	Global (`.ai`)
Padrão	`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`

Variável de ambiente de autenticação: STEPFUN_API_KEY

Catálogo integrado

Padrão (stepfun):

Referência do modelo	Contexto	Saída máxima	Observações
`stepfun/step-3.5-flash`	262,144	65,536	Modelo padrão do provedor padrão
`stepfun/step-3.7-flash`	262,144	262,144	Compatível com entrada de imagem multimodal

Step Plan (stepfun-plan):

Referência do modelo	Contexto	Saída máxima	Observações
`stepfun-plan/step-3.5-flash`	262,144	65,536	Modelo padrão do Step Plan
`stepfun-plan/step-3.7-flash`	262,144	262,144	Compatível com entrada de imagem multimodal
`stepfun-plan/step-3.5-flash-2603`	262,144	65,536	Modelo adicional do Step Plan

Primeiros passos

Padrão
Step Plan

Ideal para uso geral por meio do endpoint padrão do StepFun.

Escolha a região do endpoint

Opção de autenticação	Endpoint	Região
`stepfun-standard-api-key-intl`	`https://api.stepfun.ai/v1`	Internacional
`stepfun-standard-api-key-cn`	`https://api.stepfun.com/v1`	China

Execute a integração inicial

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

Endpoint da China:

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

Alternativa não interativa

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

Verifique se os modelos estão disponíveis

openclaw models list --provider stepfun

Modelo padrão: stepfun/step-3.5-flash Modelo alternativo: stepfun/step-3.7-flash

Ideal para o endpoint de raciocínio Step Plan.

Escolha a região do endpoint

Opção de autenticação	Endpoint	Região
`stepfun-plan-api-key-intl`	`https://api.stepfun.ai/step_plan/v1`	Internacional
`stepfun-plan-api-key-cn`	`https://api.stepfun.com/step_plan/v1`	China

Execute a integração inicial

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

Endpoint da China:

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

Alternativa não interativa

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

Verifique se os modelos estão disponíveis

openclaw models list --provider stepfun-plan

Modelo padrão: stepfun-plan/step-3.5-flash Modelos alternativos: stepfun-plan/step-3.7-flash, stepfun-plan/step-3.5-flash-2603

Um único fluxo de autenticação grava perfis correspondentes à região para stepfun e stepfun-plan; assim, as duas interfaces são descobertas juntas após uma única execução da integração inicial.

Configuração avançada

Configuração completa: provedor padrão

{
  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,
          },
        ],
      },
    },
  },
}

Configuração completa: provedor Step Plan

{
  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,
          },
        ],
      },
    },
  },
}

Observações

step-3.7-flash aceita entradas de texto e imagem por meio do OpenClaw. A API do StepFun também aceita vídeo, que ainda não é uma modalidade de entrada de modelo no OpenClaw.
O Step 3.7 aceita níveis de esforço de raciocínio low, medium e high. Como o modelo não tem um modo sem raciocínio, /think off é mapeado para low.
step-3.5-flash-2603 está disponível atualmente apenas em stepfun-plan.
Use openclaw models list e openclaw models set <provider/model> para inspecionar ou trocar de modelo.

Relacionados

Provedores de modelos

Visão geral de todos os provedores, referências de modelos e comportamento de failover.

Referência de configuração

Esquema de configuração completo para provedores, modelos e plugins.

CLI de modelos

Como escolher e configurar modelos.

Plataforma StepFun

Gerenciamento de chaves da API e documentação do StepFun.

Overview

Concepts and configuration

Providers

Instalar o plugin

Visão geral das regiões e dos endpoints

Catálogo integrado

Primeiros passos

Configuração avançada

Relacionados

Provedores de modelos

Referência de configuração

CLI de modelos

Plataforma StepFun

​Instalar o plugin

​Visão geral das regiões e dos endpoints

​Catálogo integrado

​Primeiros passos

​Configuração avançada

​Relacionados

Provedores de modelos

Referência de configuração

CLI de modelos

Plataforma StepFun

Instalar o plugin

Visão geral das regiões e dos endpoints

Catálogo integrado

Primeiros passos

Configuração avançada

Relacionados