跳转到主要内容
step-router-v1 是阶跃星辰为 Step Plan 通道提供的智能路由模型。开发者只需在 model 字段填 step-router-v1，请求会被自动路由到 deepseek-v4-pro 或 step-3.5-flash 中更合适的一个：复杂推理走 Pro、高频执行走 Flash。
仅 Step Plan 通道（https://api.stepfun.com/step_plan/v1）可用。

​
适用场景

  • 任务复杂度差异大的混合工作流：同一个 Agent 既要做格式整理、信息抽取等高频小任务，也要做架构规划、错误诊断等关键决策——交给 router 比手写路由逻辑更省心
  • Agent 长链路任务：多轮对话、含工具调用的请求，router 会在判定为复杂场景时调度 Pro 兜底质量
  • 成本敏感但又需要高质量决策的场景：默认让多数请求走 Flash 控制成本，复杂请求自动升级到 Pro 保留智能产出

​
调用方式

​
非流式

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_STEP_API_KEY",
    base_url="https://api.stepfun.com/step_plan/v1",
)

response = client.chat.completions.create(
    model="step-router-v1",
    messages=[
        {"role": "user", "content": "请帮我把这段需求拆解成开发任务列表"}
    ],
)

print(response.choices[0].message.content)

​
流式

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_STEP_API_KEY",
    base_url="https://api.stepfun.com/step_plan/v1",
)

stream = client.chat.completions.create(
    model="step-router-v1",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

​
计费机制

按实际命中模型计费——命中 deepseek-v4-pro 时按 deepseek-v4-pro 单价收费，命中 step-3.5-flash 时按 step-3.5-flash 单价收费。计费金额最终折算为 Step Plan 总额度消耗，详见 Step Plan 概览。

​
相关链接

产品介绍

step-router-v1 智能路由的产品定位、底层模型组成与定价。

接入文档

Step Plan 推理模型接入：base_url、SDK、字段差异。