# 快速開始與必要設定

## 到底需要設定什麼？

網頁工作台需要註冊帳戶與可用餘額，不需要使用者填寫上游供應商金鑰。外部工具必須設定本站 API 金鑰、介面位址及可用模型 ID。本站帳戶和餘額與其他站點獨立。

## 首次使用步驟

1. 在本站[註冊或登入](/zh-TW/app)。
2. 開啟「錢包」，聯絡客服充值，或選擇頁面目前顯示的鏈上充值管道；先閱讀[充值規則](/zh-TW/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-TW/docs/playground)，程式呼叫看[協定說明](/zh-TW/docs/api)，程式助手看 [Claude Code](/zh-TW/docs/claude-code) 或 [Codex](/zh-TW/docs/codex)。下載[串接 MD 檔案](/zh-TW/docs/agent-files)交給開發者或 AI 工具繼續實作。
