開發者設定
個人金鑰、應用程式客戶端，以及接入AI 代理或 CLI：Sofia API 頁面上的各項操作，以及這幾種方式分別適合在什麼情況下選用。
這個區塊是所有程式化功能的入口。參考文件在 API、Agents 和「將 Sofia 新增到你的應用程式」這幾個標籤頁中；本頁介紹介面上的各項操作。開啟設定，進入「Sofia API」區塊。
存取
該頁面有兩個標籤頁：「個人存取」和「應用程式用戶端」。
你的個人金鑰
- 建立金鑰。「新增金鑰」：可以為它命名，設定有效期（7 天、30 天、90 天、1 年或永不過期）以及權限。預設全部勾選；只保留你的工具需要的權限。
- 立即複製。它只顯示一次，Sofia 只保留它的指紋。
- 使用它。把它放在每次呼叫的
Authorization: Bearer請求標頭中。一個金鑰對你所有的門市生效，權限與你相同。
連接 AI 助手
對於 Claude、ChatGPT、Cursor、Gemini CLI 或 Claude Code，使用已連接應用程式中的連接器通常更簡單：它不需要任何金鑰。參見 AI 連接器。
CLI 與AI 代理
「複製代理程式說明」會給出一段文字，貼上到你的AI 代理中，它就會使用 API。sofia 命令以 sofia-post 為名發布在 npm 上，它封裝了 API，可從終端、指令碼或排程任務中發布；安裝方法見「Agents」標籤頁。
應用程式客戶端
應用程式客戶端用來構建讓其他 Sofia 使用者授權的東西，而不是以你的身份操作的東西。
- 建立客戶端。「新增用戶端」：填寫名稱、不小於 180 × 180 像素的標誌、隱私政策的地址、一到五個 HTTPS 重新導向 URL，以及應用程式可以請求的權限。名稱和標誌會在授權過程中展示給使用者。
- 複製憑證。你會得到 Client ID 和 Client Secret。公開客戶端適用於程式碼公開的應用程式，沒有金鑰，使用 PKCE 進行身分驗證；這個選擇無法更改。
- 實現授權流程。參見「將 Sofia 加到你的應用程式」標籤頁。
用金鑰還是 OAuth 客戶端？
| 標準 | 個人金鑰 | 應用程式客戶端 |
|---|---|---|
| 以誰的身份操作 | 你 | 授權它的使用者 |
| 適用於 | 你自己的指令碼和自動化 | 其他 Sofia 使用者會使用的產品 |
| 設定方式 | 複製金鑰 | 聲明客戶端並實現授權流程 |
| 撤銷方式 | 「撤銷」金鑰 | 使用者在「已連接的應用程式」中撤銷存取，或者你刪除客戶端 |
如果你自動化的是自己的發布，請使用金鑰。只有涉及他人帳號時，才需要構建客戶端。
延伸閱讀
- API：存取端點、請求負載和各平台的設定，見 API 標籤頁。
- CLI：在終端中發布，見 Agents 標籤頁。
- AI 連接器：接入 Claude、Cursor 或 ChatGPT，參見 AI 連接器。
這篇文章有幫助嗎？