如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

在 Responses API 中使用 Daybreak

為 API 請求選擇 Daybreak 存取方案。

使用 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。

只有已具備存取權的組織才能使用 gpt-5.5-cyber-preview。這個模型將於 2027 年 2 月 1 日停止服務。屆時,使用這個模型的請求都會失敗。如果你目前使用這個模型,請在該日期前將 model 欄位改為 gpt-5.6-cyber。如果你的組織已獲准使用 gpt-6-cyber,也可以依照設定說明改用該模型。切換前,請先確認你的專案具備替代模型的存取權。詳見 API 棄用公告。

模型所需核准

API 欄位值:access_programs.cyber

GPT-6 SolBlue 或 Reddaybreak_blue
GPT-6.1 Sol
GPT-6 Astra
GPT-5.5-Cyber(僅限已具備存取權的組織)
GPT-5.6 Cyber
Red
daybreak_blue
daybreak_blue
daybreak_red
daybreak_red
GPT-6 CyberRed 核准及個別模型核准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 疑難排解。