--- title: 建立防護規則指派 | RunAPI description: 將一個防護規則附加至標準 API 金鑰或帳戶成員。 url: https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/create.md canonical: https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/create locale: zh-TW --- > HTML 版本: https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/create > 代理程式網站索引: https://runapi.ai/llms.txt # 建立防護規則指派 將一個防護規則附加至標準 API 金鑰或帳戶成員。 ## 端點 POST /api/v1/guardrail_assignments 基礎 URL: https://runapi.ai API 版本: v1 身分驗證: Authorization: Bearer YOUR_MANAGEMENT_API_KEY 授權: 帳戶管理員可指派任何符合資格的目標。非管理員使用者只能指派自己的標準 API 金鑰。 ## 請求 僅在列出的請求位置中傳送值。 ### JSON 主體 ```json { "account_user_id": { "description": "帳戶成員前綴 ID。此目標需要帳戶管理員權限。", "required": false, "type": "string" }, "api_token_id": { "description": "Standard API 金鑰前綴 ID。請提供唯一一個目標 ID。", "required": false, "type": "string" }, "guardrail_id": { "description": "Guardrail 前綴 ID。", "required": true, "type": "string" } } ``` ## 成功回應 HTTP 201 - POST /api/v1/guardrail_assignments ```json { "account_user_id": null, "api_token_id": "token_123", "created_at": "2026-07-27T10:00:00.000Z", "guardrail_id": "guardrail_123", "id": "guardrail_assignment_123" } ``` ## 錯誤回應 (401) HTTP 401 ### 回應綱要 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Authentication required" } ``` ## 錯誤回應 (403) HTTP 403 ### 回應綱要 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Management API key required" } ``` ## 錯誤回應 (400) HTTP 400 ### 回應綱要 ```json { "oneOf": [ { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false }, { "properties": { "error": { "description": "人類可讀的驗證摘要。", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "以公開請求欄位為索引鍵的驗證訊息，每個欄位包含一組人類可讀的字串陣列。", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ] } ``` ### 回應範例 ```json { "error": "page must be an integer" } ``` ## 錯誤回應 (403) HTTP 403 ### 回應綱要 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Forbidden" } ``` ## 錯誤回應 (404) HTTP 404 ### 回應綱要 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Resource not found" } ``` ## 錯誤回應 (422) HTTP 422 ### 回應綱要 ```json { "properties": { "error": { "description": "人類可讀的驗證摘要。", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "以公開請求欄位為索引鍵的驗證訊息，每個欄位包含一組人類可讀的字串陣列。", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Validation failed", "errors": { "base": [ "Validation failed" ] } } ``` ## cURL 範例 ### curl ```curl curl -X POST https://runapi.ai/api/v1/guardrail_assignments \ -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"guardrail_id":"guardrail_123","api_token_id":"token_123"}' ``` ## 相關參考資料 - [護欄分配](https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments.md) - [Guardrail Assignment 物件](https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/object.md) --- ## RunAPI 的更多內容 - [首頁](https://runapi.ai/zh-TW/.md) - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models) - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [代理程式網站索引](https://runapi.ai/llms.txt) 聯絡我們: contact@runapi.ai ## 結構化資料 ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "TechArticle", "headline": "建立防護規則指派", "description": "將一個防護規則附加至標準 API 金鑰或帳戶成員。", "url": "https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/create", "mainEntityOfPage": "https://runapi.ai/zh-TW/docs/api/management/guardrail-assignments/create" } ] ```