> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Step Explore

Step Explore 是阶跃星辰面向 Agent 与 Coding 场景推出的新模型，强化了复杂指令理解、长程规划与多步骤任务处理能力，适用于代码开发、任务规划、Agent 工作流等需要多步骤理解与持续推进的复杂任务。如果您正在构建这类应用，欢迎申请体验。

Step Explore 使用统一的 Model ID `step-explore`，模型能力会随版本迭代持续更新，您无需关注版本切换或调整调用方式，即可使用最新版本。

Step Explore 当前为申请制开放：通过本文末尾的申请表提交申请，审核通过后即可通过 [Step Plan](/docs/zh/step-plan/overview) 通道调用，用量折算为 Step Plan 额度消耗。审核通过时，如果您的账号没有生效中的 Step Plan 订阅，我们会一并赠送 30 天 Flash Pro 订阅，供您体验模型能力。本文介绍 Step Explore 的使用范围、申请方式、接入方法和计费规则。

<Warning>
  权限开通后的 14 个自然日内，若系统未检测到您账号（UID）的调用记录，该 UID 的使用权限将被关闭，且关闭后无法恢复或重新申请。获得权限后建议尽快接入使用。
</Warning>

## 使用前须知

| 项目       | 说明                                                                         |
| :------- | :------------------------------------------------------------------------- |
| Model ID | `step-explore`                                                             |
| 开放方式     | 申请制，审核通过后按 UID 开通                                                          |
| 上下文长度    | 符合使用范围的账号优先提供最高 1M tokens；持续用于批量自动化任务的账号将调整为 `step-3.7-flash`（256K），详见下文说明 |
| 可用通道     | Step Plan 通道，调用消耗 Step Plan 额度                                             |
| 请求地址     | `POST https://api.stepfun.com/step_plan/v1/messages`                       |
| 支持协议     | 仅支持 Anthropic Messages 协议                                                  |
| 认证方式     | 请求头 `Authorization: Bearer <YOUR_API_KEY>`                                 |
| 计费       | 按与 `step-3.7-flash` 相同的价格折算为 Step Plan 额度消耗                                |
| 权限保留     | 开通后 14 个自然日内需产生调用记录，详见本文开头说明                                               |

## 使用范围与上下文长度

Step Explore 当前优先服务于开发者实时参与的 Coding 与 Agent 任务。对于符合这一使用范围的账号，我们优先提供最高 1M tokens 的上下文服务，输入与输出的总长度不能超过该上限。

典型场景包括：

* 在 IDE 或终端中进行代码开发、调试与问题排查；
* 围绕单个开发任务开展多轮协作；
* 由开发者发起、跟进，并在关键步骤进行确认的 Agent 任务。

Step Explore 当前不面向持续批量、无人值守的自动化处理场景。如果账号的调用整体长期呈现以下特征，平台将调整该账号的服务配置：

* 无人值守地持续循环调用；
* 以固定频率长时间发送大量请求；
* 对大量同类数据进行批量改写、打标、生成或其他同质化处理。

服务配置调整后，该账号后续通过 `step-explore` 发起的请求将由 `step-3.7-flash` 提供服务，上下文上限为 256K tokens，模型能力与输出表现可能发生变化。该调整按账号（UID）生效，且不支持恢复。调整生效时，我们会通过申请时填写的邮箱通知您。

<Warning>
  服务配置调整后，请按 256K tokens 规划单次请求和会话长度。超过该上限的请求将失败；已有的长会话也可能因为历史内容超过 256K 而无法继续。
</Warning>

如果您的场景本身就是批量、无人值守的大流量处理，建议直接使用 [Step 3.7 Flash](/docs/zh/guides/models/step-3.7-flash)。该模型无需申请即可调用，更适合承接此类任务。

## 申请与开通

<Steps>
  <Step title="获取开放平台 UID">
    注册并登录 [StepFun 开放平台](https://platform.stepfun.com/)，在 [个人中心](https://platform.stepfun.com/account-info) 查看您的账户 UID。
  </Step>

  <Step title="提交申请">
    通过 [申请表](https://wvixbzgc0u7.feishu.cn/share/base/form/shrcnhaUCjPMGT13kA3C95qiPxg) 提交 UID、实际使用经历与计划使用场景。每个 UID 仅有一次申请机会，建议尽量具体地说明您计划用 Step Explore 完成的开发任务，便于我们判断是否符合当前的开放范围。
  </Step>

  <Step title="等待审核">
    审核通常在 1 个工作日内完成，周末与节假日顺延。审核通过后，我们会为申请时填写的 UID 开通 Step Explore 使用权限，并向申请时填写的邮箱发送通知。未通过的申请不会单独发送邮件。
  </Step>

  <Step title="创建 API Key，开始使用">
    在 [接口密钥](https://platform.stepfun.com/interface-key) 页面创建或查看 API Key，即可按下文的快速开始接入 `step-explore`。若审核通过时您的账号没有生效中的 Step Plan 订阅，我们会为该账号赠送 30 天 [Flash Pro](/docs/zh/step-plan/overview#套餐档位) 订阅，可直接用于体验；若账号已有生效中的订阅，则继续使用您当前的订阅额度。
  </Step>
</Steps>

<Note>
  赠送的 30 天 Flash Pro 到期后，模型权限仍然保留，但需要您自行订阅 Step Plan 才能继续调用 Step Explore。
</Note>

## 快速开始

Step Explore 使用 Anthropic Messages 协议，通过 Step Plan 专属地址调用。如果您已经在用 Anthropic SDK，把 base\_url 指向 `https://api.stepfun.com/step_plan`（SDK 会自动拼接 `/v1/messages`），模型填 `step-explore` 即可。

```bash theme={null}
curl https://api.stepfun.com/step_plan/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEP_API_KEY" \
  -d '{
    "model": "step-explore",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ]
  }'
```

调用前请确认：

* 账号有生效中的 Step Plan 订阅（含赠送的 Flash Pro），且额度充足；
* 当前 API Key 属于申请时填写的 UID；
* 已收到审核通过通知，模型权限已开通；
* 请求地址带 `/step_plan/v1` 路径前缀；
* `model` 的值为 `step-explore`。

## 接口说明

Step Explore 的请求和响应遵循 Anthropic Messages 协议，完整的参数与响应结构请参考 [Messages API 文档](/docs/zh/api-reference/chat/messages-create)。使用时请注意：Step Explore 不支持 `thinking` 请求参数，请不要在请求中传入该字段。

更多接入方式（Agent 工具与编码助手配置）详见 [Step Plan 推理模型接入](/docs/zh/step-plan/integrations/reasoning-api)。

## 计费

`step-explore` 按与 `step-3.7-flash` 相同的价格计费，计费金额最终折算为 Step Plan 总额度（Credit）消耗，从当月额度中扣减。各档位权益与 Credit 换算规则详见 [Step Plan 概览](/docs/zh/step-plan/overview)。

## 限流

高频请求可能触发 HTTP 429（`rate_limited`）错误。建议您：

* 客户端收到 429 后采用指数退避重试，并设置最大重试次数；
* 控制并发数量，避免在短时间内集中发送大量请求；
* 如需更高配额，请 [联系我们](/docs/zh/guides/contact-us)。

## 常见问题

### 提交申请后多久能收到结果？

审核通常在 1 个工作日内完成，周末与节假日顺延。审核通过后，我们会为申请时填写的 UID 开通权限，并向申请时填写的邮箱发送通知。如果提交后 2 个工作日内没有收到通知邮件，说明本次申请暂未通过。Step Explore 当前开放规模有限，优先面向开发者实时参与的 Coding 与 Agent 任务；如果申请中的场景描述不够具体，或与当前的开放范围差异较大，我们暂时无法开通。

如果您的任务不在当前的开放范围内，可以直接使用 [Step 3.7 Flash](/docs/zh/guides/models/step-3.7-flash)，该模型无需申请即可调用。

### 申请未通过后可以再次提交吗？

每个 UID 仅有一次申请机会，本次未通过后暂不支持重新提交，建议在首次提交前尽量具体地描述使用场景。

### 必须订阅 Step Plan 才能使用吗？

如果审核通过时您的账号没有生效中的 Step Plan 订阅，我们会赠送 30 天 [Flash Pro](/docs/zh/step-plan/overview#套餐档位) 订阅，您无需自行订阅即可开始体验；如果账号已有生效中的订阅，则直接使用当前订阅的额度，不再重复赠送。赠送的 30 天到期后，需自行订阅 Step Plan 才能继续调用。

### 账户余额可以用于调用 Step Explore 吗？

不可以。Step Explore 通过 Step Plan 通道调用，消耗的是 Step Plan 订阅的 Credit 额度，与开放平台的账户充值余额相互独立。如果审核通过时您的账号没有生效中的订阅，可以使用获赠的 30 天 Flash Pro 额度体验。

### 审核通过后可以免费使用吗？

Step Explore 不单独发放免费额度，调用按与 `step-3.7-flash` 相同的价格折算为 Step Plan 额度消耗。如果您的账号在审核通过时没有生效中的订阅，可用获赠的 30 天 Flash Pro 额度体验，无需额外付费。

### 可以用 OpenAI Chat Completions 调用吗？

暂不支持。Step Explore 当前仅支持 Anthropic Messages 协议，向 `/chat/completions` 发送请求会返回 HTTP 400。请改用 `https://api.stepfun.com/step_plan/v1/messages`。

### 服务配置调整后会有什么变化？

调整生效时，我们会通过申请时填写的邮箱通知您。后续通过 `step-explore` 发起的请求将由 `step-3.7-flash` 提供服务，上下文上限调整为 256K tokens，模型能力与输出表现可能发生变化，超过 256K 的请求将失败。

### 服务配置调整后可以恢复吗？

不可以。该调整按账号（UID）生效，不支持恢复。

### 请求失败时应该检查什么？

请依次确认：账号是否有生效中的 Step Plan 订阅且额度充足、当前 API Key 是否属于申请时填写的 UID、权限是否已开通、请求地址是否为 `/step_plan/v1/messages`、是否通过 `Authorization: Bearer` 请求头正确传入 API Key、`model` 是否为 `step-explore`、是否传入了必填的 `max_tokens`。如以上均无异常，请 [联系我们](/docs/zh/guides/contact-us) 并提供 UID、请求时间、HTTP 状态码和错误信息（出于安全考虑，请不要提供完整的 API Key）。

### 14 个自然日内没有调用会怎样？

该 UID 的 Step Explore 使用权限将被关闭，且无法恢复或重新申请。建议获得权限后尽快接入，如接入过程中遇到问题，欢迎随时 [联系我们](/docs/zh/guides/contact-us)。

## 申请使用

Step Explore 当前优先面向开发者实时参与的 Coding 与 Agent 任务开放。准备好 UID 和具体使用场景描述，即可提交申请。审核通过后，我们会向申请时填写的邮箱发送开通通知。

<Card title="申请使用 Step Explore" href="https://wvixbzgc0u7.feishu.cn/share/base/form/shrcnhaUCjPMGT13kA3C95qiPxg">
  填写申请表，提交 UID、实际使用经历与计划使用场景。
</Card>
