需在dify中配置stepfun为openai兼容模型提供方，base url为https://api.stepfun.com/v1，api key为sk-开头32位密钥，model name严格填step-1-mini等官方支持模型名，配额非零且网络可达方可成功调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中调用阶跃星辰Step系列大模型（如step-1-mini、step-5-preview等），需绕过其官方API控制台的限制，手动配置兼容OpenAI协议的接口参数，并确保模型名称、鉴权方式与实际服务端严格一致。
确认阶跃星辰API可用性与模型列表
打开 阶跃星辰模型中心，确认当前已开通权限的模型。step-5-preview虽已开源权重，但API服务端仅对Mini Plan及以上套餐开放step-1-mini、step-1-32k等在线推理模型；step-5-preview暂未开放公测API，不可填入Dify模型字段。
登录后进入「配额管理」页面，查看「API调用次数」与「并发数」是否为非零值——若显示“未开通”或配额为0，后续所有配置均无法生效。
在Dify中添加阶跃星辰为自定义模型提供方
进入Dify后台 → 设置 → 模型提供方 → 点击「+ 添加模型提供方」→ 选择「OpenAI 兼容」。
填写以下三项必填字段：
Provider Name：填“StepFun”（仅作标识，不影响调用）
Base URL：【https://api.stepfun.com/v1】
API Key：【sk-开头的32位密钥，从https://platform.stepfun.com/interface-key复制】
这一步不能填错URL末尾的/v1，少斜杠会导致404；也不能误用Hugging Face上的开源权重地址，那不是API入口。
配置具体模型并启用
方法一：使用Dify内置模型配置流程
① 在刚创建的“StepFun”提供方下点击「+ 添加模型」
② Model Name 填写 【step-1-mini】（注意大小写与短横线，官方不支持step1mini或STEP1MINI）
③ Model Type 选「LLM」
④ 点击「保存」后，该模型会出现在「可用模型」列表中
⑤ 返回应用编辑页，在「模型配置」中选择此模型并设为默认
方法二：跳过界面，直接修改环境变量（适用于Dify自托管用户）
在docker-compose.yml的dify-server服务块中追加环境变量：
DIFY_MODEL_PROVIDER_STEPFUN_MODELS=step-1-mini,step-1-32k
重启服务后，这两个模型将自动注入模型选择器。
注意：模型名必须与阶跃星辰API文档完全一致，多一个空格或换行都会触发400错误返回“model not found”。
测试调用与调试响应
进入Dify应用编辑页 → 调试 → 输入任意提示词（例如“你好”）→ 点击运行。
若返回正常文本，说明配置成功；若报错“Authentication failed”，检查API Key是否被截断或含不可见字符；若报错“Request timeout”，说明Base URL端口不通，需确认服务器能否访问https://api.stepfun.com（部分企业防火墙会拦截stepfun域名）。
这一步操作起来很简单，直接把提示词输进去点运行就行。
