使用 access_programs.cyber 為 Responses API 請求選擇資安存取方案。Daybreak Blue 與 Daybreak Red 方案提供執行資安工作所需的存取權,須經核准才能使用。其他 API 資安防護措施仍然適用。
使用 Daybreak 前,請先完成組織核准流程與專案設定。你的專案必須同時具備方案與模型的存取權。請使用該專案的 API 金鑰。請求參數只能在已核准的存取範圍內指定請求的處理方式,無法授予存取權。
所有 Daybreak Red 組織都必須為具備 Cyber 存取權的 API 組織設定強制使用 SSO,並透過身分識別提供者強制執行 MFA。如果你另設了專用的 Cyber 組織,請驗證該組織的網域,並在該組織中測試 SSO。
選擇模型與存取方案
使用 model 欄位指定模型,再用 access_programs.cyber 欄位為該請求指定支援的存取方案:standard、daybreak_blue 或 daybreak_red。
| 模型 | 所需核准 | API 欄位值: |
|---|---|---|
| GPT-6 Sol | Blue 或 Red | daybreak_blue |
GPT-6.1 Sol GPT-6 Astra GPT-5.5-Cyber(僅限已具備存取權的組織) GPT-5.6 Cyber | Red | daybreak_bluedaybreak_bluedaybreak_reddaybreak_red |
| GPT-6 Cyber | Red 核准及個別模型核准 | daybreak_red |
請依模型選擇請求中的參數值,而非依組織的核准層級選擇。例如,搭配 Daybreak 使用 gpt-6-sol 時,即使組織已取得 Daybreak Red 核准,仍須傳送 daybreak_blue。若對這個模型傳送 daybreak_red,API 會傳回 invalid_access_program。
若要讓 gpt-6-astra 和 gpt-6.1-sol 減少拒絕回應的情況,必須具備 Daybreak Red 存取權,但請求中的參數值須設為 daybreak_blue。這兩個模型都不接受 daybreak_red。僅取得 Daybreak Blue 核准,無法讓任一模型減少拒絕回應的情況。你的專案也必須啟用所需的存取權。
傳送請求
取得 Daybreak Blue 核准後,請在請求中明確指定 daybreak_blue,並搭配支援 Daybreak 的模型,例如 gpt-6-sol:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"input": "Explain how to validate a security patch in a test environment.",
"access_programs": {
"cyber": "daybreak_blue"
}
}'如果組織已取得 Daybreak Red 核准,且專案已啟用存取權,你也可以使用 gpt-6.1-sol。請求中仍須指定 daybreak_blue:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"input": "Explain how to validate a security patch in a test environment.",
"access_programs": {
"cyber": "daybreak_blue"
}
}'access_programs 和 cyber 都是選填欄位,但在請求中都不能設為 null。傳送空的 access_programs 物件表示未指定方案。
省略參數時的預設行為
從 gpt-6.1-terra 開始,若省略 access_programs.cyber 參數,API 會以 standard 方式處理請求,不再預設採用可用的最高 Daybreak 層級。
對於下列模型,省略 access_programs.cyber 時的預設行為如下:
- 主線模型,例如
gpt-6-sol: 若組織與專案都具備所需的存取權,API 會依 Daybreak Blue 方案處理請求,否則會採用標準防護措施。 - Red 模型,例如
gpt-5.6-cyber: API 會選擇daybreak_red。若缺少所需的存取權,請求就會失敗。 gpt-6-astra和gpt-6.1-sol: 若呼叫端符合資格,且其專案已啟用 Daybreak Red 存取權,模型拒絕回應的情況就會減少,否則會採用標準防護措施。
模型權限仍然適用。若要停用 Daybreak,讓相容的模型採用標準防護措施,即使你具備 Daybreak 存取權,也請將 access_programs.cyber 設為 standard。若明確指定的 Daybreak 方案與模型不相容,或你缺少所需的存取權,請求就會失敗。
檢查回應
回應中若有 access_programs.cyber 欄位,即可從該欄位查看選用的方案。以下回應片段顯示,gpt-6.1-sol 請求使用的是 Daybreak Blue:
{
"model": "gpt-6.1-sol",
"access_programs": {
"cyber": "daybreak_blue"
}
}若未指定方案,且請求採用標準防護措施,access_programs 的值會是 null。若使用 -latest 別名,請查看 model 欄位,確認實際處理請求的模型。別名對應的模型可能會變動,也會因你獲准的存取範圍而異。
設定 GPT-6 Cyber
請向負責你帳戶的團隊確認,你的組織已具備 Daybreak Red 存取權,且已獲准使用 GPT-6 Cyber。
專案存取權。 請組織擁有者為將要傳送請求的專案啟用 Daybreak Red。若採用專案層級的存取控制,請使用非預設專案,並使用該專案的金鑰。
IP 允許清單。 若要透過 API 使用 GPT-6 Cyber,請設定 IP 允許清單,將應用程式傳送請求時使用的公用來源 IP 位址加入清單。如果你已獲准將模型整合至產品中,沒有模型直接存取權的終端使用者無須將自己的 IP 位址加入允許清單。
零資料保留。 如果專案採用零資料保留(ZDR),請設定 Private Safety Processing(PSP)。請確認儲存狀態顯示「Validated」,且專案的保留政策為「Zero Data Retention with Private Safety Processing」。PSP 適用於該專案的所有 API 流量。
傳送 GPT-6 Cyber 請求
將 OPENAI_API_KEY 設為已獲核准專案的金鑰。請用代表發出請求之使用者的假名識別碼取代範例中的安全識別碼,並為同一位使用者持續使用同一個識別碼。
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-cyber",
"access_programs": {"cyber": "daybreak_red"},
"safety_identifier": "user_a17f",
"input": "Suggest a regression test for a path traversal fix."
}'
若請求失敗,請檢查金鑰所屬的專案、目前生效的 IP 允許清單,以及專案的保留政策。請參閱 Daybreak API 錯誤。
處理錯誤
| HTTP 狀態與錯誤碼 | 處理方式 |
|---|---|
400 invalid_access_program |
所選模型需要不同的方案值。請將 access_programs.cyber 改為錯誤訊息中指定的值,再重試。 |
400 unsupported_access_program |
請改用支援 Daybreak 的模型,或將 access_programs.cyber 設為 standard,以標準防護措施繼續使用目前的模型。 |
403 access_program_not_enabled |
請確認 API 金鑰所屬的專案已啟用所需方案。若組織尚未取得核准,請申請錯誤訊息中指定的 Daybreak 層級。若專案缺少存取權,請組織管理員為專案啟用該方案。 |
若請求包含未知欄位、無效值或 null 值,就無法通過驗證。API 會另外檢查模型權限。即使選用了 Daybreak 方案,也無法保證每項安全檢查都會通過,或每個提示詞都能獲得回應。如需更多協助,請參閱 Daybreak 疑難排解。