# 快速开始与必填配置

## 到底需要配置什么？

网页工作台需要注册账户并准备可用余额，不需要用户填写上游供应商密钥。外部工具必须配置本站 API 密钥、接口地址和可用的模型 ID。本站账号和余额与其他站点独立。

## 第一次使用按这个顺序操作

1. 在本站[注册或登录](/zh-CN/app)。
2. 打开「钱包」，联系客服充值，或选择页面当前展示的链上充值渠道；先阅读[充值规则](/zh-CN/docs/billing)。
3. 打开「API 密钥」，为每个工具单独创建密钥，显示时立即保存；已撤销或已过期的密钥不能继续使用。
4. 从账户实时模型目录复制 API 模型 ID；展示名称不一定等于请求里的 model 值。

| 配置项 | 应填写的内容 |
| --- | --- |
| OpenAI 兼容接口基址 | https://u9ai.ai/v1 |
| Claude Code 网关根地址 | https://u9ai.ai |
| 认证凭据 | 自己在本站创建的 API 密钥 |
| 模型 | 对应协议且账户可用的 API 模型 ID |

## 先验证密钥，再发生成请求

在本机把自己的密钥设置为 U9AI_API_KEY 环境变量，再执行下面的只读检查。不要把密钥写进工单、Markdown 文件或代码仓库。该请求只验证认证和目录查询，不代表生成、流式输出或工具调用已经通过测试。

```bash
curl --fail-with-body -sS "https://u9ai.ai/v1/models" \
  -H "Authorization: Bearer $U9AI_API_KEY"
```

```powershell
Invoke-RestMethod -Uri "https://u9ai.ai/v1/models" -Headers @{Authorization="Bearer $env:U9AI_API_KEY"}
```

## 接下来按用途阅读

网页创作看[参数与下载](/zh-CN/docs/playground)，程序调用看[协议说明](/zh-CN/docs/api)，编程助手看 [Claude Code](/zh-CN/docs/claude-code) 或 [Codex](/zh-CN/docs/codex)。需要交给开发者或 AI 工具继续实施时，下载[对接 MD 文件](/zh-CN/docs/agent-files)。