Utilisez Daybreak dans l’API Responses

Utilisez access_programs.cyber pour sélectionner un programme d’accès en cybersécurité pour une requête adressée à l’API Responses. Les programmes Daybreak Blue et Daybreak Red permettent aux organisations approuvées de mener des travaux de cybersécurité. Les autres mesures de protection de l’API en matière de cybersécurité continuent de s’appliquer.

Avant d’utiliser Daybreak, suivez les étapes pour faire approuver votre organisation et configurer votre projet. Votre projet doit avoir accès à la fois au programme et au modèle. Utilisez une clé API de ce projet. Le paramètre de la requête sélectionne un comportement parmi ceux auxquels vous avez déjà accès. Il n’accorde aucun droit d’accès.

Toutes les organisations Daybreak Red doivent rendre le SSO obligatoire pour l’organisation API qui dispose de l’accès Cyber et imposer l’authentification multifacteur (MFA) via leur fournisseur d’identité. Si vous utilisez une organisation distincte pour Cyber, vérifiez son domaine et testez le SSO dans cette organisation.

Choisissez le modèle et le programme d’accès

Le champ model permet de sélectionner le modèle. Le champ access_programs.cyber permet de choisir un programme d’accès pris en charge pour cette requête : standard, daybreak_blue ou daybreak_red.

Choisissez la valeur à envoyer en fonction du modèle, indépendamment du niveau d’approbation de votre organisation. Par exemple, si vous utilisez gpt-6-sol avec Daybreak, envoyez daybreak_blue même si votre organisation a obtenu l’approbation Daybreak Red. Si vous envoyez daybreak_red avec ce modèle, l’API renvoie invalid_access_program.

Envoyez une requête

Si vous avez obtenu l’approbation Daybreak Blue, commencez par sélectionner explicitement daybreak_blue avec un modèle compatible avec Daybreak, comme gpt-6-sol :

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"
    }
  }'

Si votre organisation a obtenu l’approbation Daybreak Red et que l’accès est activé pour votre projet, vous pouvez également utiliser gpt-6.1-sol. La valeur à sélectionner dans la requête reste 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"
    }
  }'

Les champs access_programs et cyber sont tous deux facultatifs, mais aucun n’accepte la valeur null dans une requête. Si l’objet access_programs est vide, aucun programme n’est spécifié.

Comportement par défaut en l’absence de sélection

À partir de gpt-6.1-terra, si vous omettez le paramètre access_programs.cyber, l’API applique à la requête le traitement standard au lieu de sélectionner par défaut le niveau Daybreak le plus élevé disponible.

Pour les modèles ci-dessous, si vous omettez access_programs.cyber, l’API applique les règles suivantes :

• Modèles de la gamme principale, comme gpt-6-sol : l’API applique le traitement Daybreak Blue si votre organisation et votre projet disposent de l’accès requis. Dans le cas contraire, elle applique les mesures de protection standard.
• Modèles Red, comme gpt-5.6-cyber : l’API sélectionne daybreak_red. La requête échoue si vous ne disposez pas de l’accès requis.
• gpt-6-astra et gpt-6.1-sol : les refus sont moins fréquents pour les utilisateurs éligibles dont le projet dispose d’un accès actif à Daybreak Red. Dans les autres cas, l’API applique les mesures de protection standard.

Les autorisations propres au modèle continuent de s’appliquer. Pour désactiver Daybreak et demander les mesures de protection standard sur un modèle compatible, définissez access_programs.cyber sur standard, même si vous avez accès à Daybreak. Si vous sélectionnez explicitement un programme Daybreak, la requête échoue si le programme est incompatible avec le modèle ou si vous ne disposez pas de l’accès requis.

Vérifiez la réponse

Lorsqu’il est disponible, le champ access_programs.cyber indique le programme sélectionné. Cet extrait de réponse indique que l’API a sélectionné Daybreak Blue pour la requête utilisant gpt-6.1-sol :

1
2
3
4
5
6{
  "model": "gpt-6.1-sol",
  "access_programs": {
    "cyber": "daybreak_blue"
  }
}

Si aucun programme n’est spécifié et que l’API applique les mesures de protection standard à la requête, access_programs vaut null. Si vous utilisez un alias -latest, consultez le champ model pour savoir quel modèle a traité la requête. Le modèle auquel correspond l’alias peut changer et dépend de vos droits d’accès.

Configurez GPT-6-Cyber

Vérifiez auprès de l’équipe chargée de votre compte que votre organisation a accès à Daybreak Red et a obtenu l’approbation requise pour GPT-6-Cyber.

Accès du projet. Demandez à un propriétaire de l’organisation d’activer Daybreak Red pour le projet qui enverra les requêtes. Si vous utilisez des contrôles au niveau du projet, choisissez un projet autre que le projet par défaut et utilisez une clé de ce projet.

Adresses IP autorisées. Pour utiliser GPT-6-Cyber via l’API, configurez une liste d’adresses IP autorisées en y ajoutant les adresses IP publiques à partir desquelles votre application envoie ses requêtes. Si vous avez obtenu l’autorisation d’intégrer le modèle dans un produit, les utilisateurs finaux qui n’ont pas d’accès direct au modèle n’ont pas besoin d’ajouter leurs propres adresses IP à la liste.

Politique de non-conservation des données. Si le projet applique la politique de non-conservation des données (ZDR), configurez Private Safety Processing (PSP). Vérifiez que l’état du stockage est « Validated » et que la politique de conservation du projet est « Zero Data Retention with Private Safety Processing ». Le PSP s’applique à tout le trafic API de ce projet.

Envoyez une requête à GPT-6-Cyber

Attribuez à OPENAI_API_KEY la valeur d’une clé du projet approuvé. Remplacez l’identifiant de sécurité de l’exemple par un identifiant pseudonyme stable propre à l’utilisateur qui envoie la requête.

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

Si la requête échoue, vérifiez le projet associé à la clé, la liste d’adresses IP autorisées en vigueur et la politique de conservation du projet. Consultez la section sur les erreurs de l’API liées à Daybreak.

Gérez les erreurs

L’API rejette lors de la validation toute requête qui contient des champs inconnus, des valeurs non valides ou des valeurs null. Elle vérifie séparément les autorisations propres au modèle. La sélection d’un programme Daybreak ne garantit ni que la requête passera tous les contrôles de sécurité ni que chaque prompt aboutira. Pour obtenir de l’aide, consultez le guide de dépannage de Daybreak.