Responses API에서 Daybreak 사용하기

access_programs.cyber로 Responses API 요청에 적용할 사이버 보안 액세스 프로그램을 선택하세요. Daybreak Blue 및 Daybreak Red 프로그램은 사이버 보안 작업을 위해 승인된 액세스 권한을 제공합니다. 그 밖의 API 사이버 보안 보호 조치도 계속 적용됩니다.

Daybreak를 사용하기 전에 조직 승인 및 프로젝트 설정을 완료하세요. 프로젝트에 프로그램과 모델 모두에 대한 액세스 권한이 있어야 합니다. 해당 프로젝트의 API 키를 사용하세요. 요청 매개변수는 승인된 권한 범위 안에서 요청 처리 방식을 선택하는 용도이며, 액세스 권한을 부여하지 않습니다.

모든 Daybreak Red 조직은 Cyber 액세스 권한이 있는 API 조직에서 SSO를 필수로 설정하고, ID 공급자를 통해 다중 인증(MFA)을 의무화해야 합니다. 별도의 Cyber 조직을 사용한다면 해당 조직의 도메인을 검증하고 그 조직에서 SSO를 테스트하세요.

모델 및 액세스 프로그램 선택

model 필드로 모델을 선택합니다. access_programs.cyber 필드에는 해당 요청에서 지원하는 프로그램 값인 standard, daybreak_blue, daybreak_red 중 하나를 지정합니다.

조직의 승인 등급과 관계없이 모델에 맞는 요청 값을 지정하세요. 예를 들어 gpt-6-sol에서 Daybreak를 사용할 때는 조직이 Daybreak Red 승인을 받았더라도 daybreak_blue를 보내세요. 이 모델에 daybreak_red를 보내면 invalid_access_program 오류가 반환됩니다.

요청 보내기

Daybreak Blue 승인을 받았다면 daybreak_blue를 명시적으로 지정하고 gpt-6-sol처럼 Daybreak를 지원하는 모델로 요청을 보내세요.

1
2
3
4
5
6
7
8
9
10curl 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를 지정합니다.

1
2
3
4
5
6
7
8
9
10curl 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 매개변수를 생략하면 요청에 standard가 적용됩니다. 사용할 수 있는 가장 높은 Daybreak 등급이 자동으로 적용되지는 않습니다.

아래 모델에서 access_programs.cyber를 생략하면 다음과 같이 처리됩니다.

• gpt-6-sol 등의 주력 모델: 조직과 프로젝트에 필요한 액세스 권한이 있으면 Daybreak Blue가 적용됩니다. 그 외에는 표준 보호 조치가 적용됩니다.
• gpt-5.6-cyber 등의 Red 모델: 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가 적용되었음을 보여 주는 응답의 일부입니다.

1
2
3
4
5
6{
  "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를 승인된 프로젝트의 키로 설정하세요. 예시의 안전 식별자를 요청을 보내는 사용자별로 일관되게 사용하는 가명 식별자로 바꾸세요.

123456789curl 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."
  }'

요청이 실패하면 API 키가 속한 프로젝트, 현재 적용 중인 IP 허용 목록, 프로젝트의 보존 정책을 확인하세요. Daybreak API 오류를 참고하세요.

오류 처리

요청에 알 수 없는 필드, 유효하지 않은 값 또는 null 값이 있으면 유효성 검사에 실패합니다. 모델 권한은 별도로 확인합니다. Daybreak 프로그램을 선택해도 모든 안전 검사를 통과하거나 모든 프롬프트가 성공적으로 처리된다고 보장할 수는 없습니다. 도움이 더 필요하면 Daybreak 문제 해결을 참고하세요.