> ## 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.

# 创建并使用项目 API Key

加入组织后，您可以在所参与的项目下创建 API Key。用它发起的调用由组织的 Credit 账户承担费用，不消耗您个人账号的额度。

## 接受邀请

主账号发起邀请后，您会收到一条含邀请链接的短信。点击链接进入邀请页面：

* 手机号已注册平台账号：点击「确认加入组织」，即成为该组织的成员。
* 手机号尚未注册：点击「去注册」完成注册，注册成功后自动加入该组织。

邀请链接自发起时刻起 7 天内有效，过期后请联系邀请人重新发送。

## 切换到组织空间

通过控制台右上角的「用户中心 > 空间切换」进入组织空间。项目下 API Key 的创建与用量查询都在该空间下进行。如需退出组织，请联系主账号。

## 创建 API Key

1. 在组织空间进入「账户管理 > 接口密钥」。该页面按项目列出您参与的每个项目，每个项目下最多创建一个 API Key。
2. 在目标项目行点击「创建密钥」，填写名称（不超过 20 字）后确认。
3. 复制并妥善保存完整的 API Key。

> [!WARNING]
>
> 请妥善保管您的 API Key，不要写入代码仓库或分享给他人。任何获得该 Key 的人都能以您的身份调用模型，并消耗组织的 Credit。

已创建的 API Key 可以修改名称或删除。删除后该 API Key 立即失效且无法撤回，如需继续使用可在该项目下重新创建。

状态显示为「已被管理员禁用」时，该 API Key 已由主账号禁用，请联系主账号处理。

## 发起调用

项目下 API Key 的使用方式与个人 API Key 一致，不需要额外传递组织或项目标识。

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
curl https://api.stepfun.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEPFUN_API_KEY" \
  -d '{
    "model": "step-5-preview",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'
```

调用产生的费用从组织的 Credit 账户扣减，并计入对应的项目与成员。完整的接口说明见 [Chat Completions](https://platform.stepfun.com/docs/zh/api-reference/chat/chat-completion-create.md)。

## 查看自己的用量

「账户管理 > 使用详情」展示您的调用明细，每一行对应一个计费项，可按密钥名称、模型与日期区间筛选，并导出当前筛选结果。

「账户管理 > 接口密钥」中的「Credit 已用 / 上限」一列展示您在该项目下的当期用量。上限显示为「不限」时，表示主账号未对您单独设置上限，此时仍受项目整体上限与组织 Credit 余额的约束。上限于每月 1 号 00:00 重置。

## 调用被拒绝时的排查

| 现象 | 原因 | 处理方式 |
| - | - | - |
| 402 `insufficient_credit` | 组织的 Credit 账户余额不足 | 联系主账号补充 Credit |
| 429 `project_credit_limit_exceeded` | 所在项目达到当期 Credit 上限 | 联系主账号调高项目上限，或等待下月 1 号重置 |
| 429 `member_project_credit_limit_exceeded` | 您在该项目内达到当期 Credit 上限 | 联系主账号调高您的上限，或等待下月 1 号重置 |
| API Key 不可用 | API Key 已被禁用或删除，或您已被移出该项目、该组织 | 在「账户管理 > 接口密钥」确认状态，必要时联系主账号 |
| 401 `invalid_api_key`：`Error code: 401 - {'error': {'message': 'Incorrect API key provided', 'type': 'invalid_api_key'}}` | 您使用的是组织空间的 API Key，不能用于 Step Plan 的 Base URL `https://api.stepfun.com/step_plan/v1/chat/completions` | 将 Base URL 改为 `https://api.stepfun.com/v1/chat/completions`，调用成功后从当前组织的 Credit 账户扣费 |

额度上限与速率限制返回的状态码同为 429，收到 429 时请以错误标识区分两种情况，错误标识的对照见[错误码](https://platform.stepfun.com/docs/zh/api-reference/error-codes.md)。额度规则的完整说明见 [组织 Credit 额度规则](https://platform.stepfun.com/docs/zh/guides/organization/credits.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.