Envoyer une requête API GetAPI.ONE

Prérequis et limites

• Une clé GetAPI.ONE à portée limitée, stockée dans GETAPI_ONE_API_KEY.
• Un modèle actuel du catalogue qui mentionne explicitement le type de point de terminaison que vous souhaitez appeler.
• Une ligne de commande sur laquelle curl est installé et où les connexions HTTPS sortantes vers www.getapi.one sont autorisées.
• Acceptation du fait qu’une requête réelle peut entraîner des frais d’utilisation. Les exemples ont été examinés sans envoyer de requêtes de modèle.

• Créer et charger une clé
• Choisir un modèle compatible avec le point de terminaison

1. Choisir le point de terminaison déclaré

Les autres familles de protocoles utilisent des chemins et des corps de requête différents. Suivez le point de terminaison affiché sur la page du modèle sélectionné ; ne ramenez pas les appels Anthropic, Gemini, image ou vidéo aux deux exemples ci-dessus.

2. Exemple de l’API Responses

Utilisez cet exemple uniquement après avoir choisi un modèle du catalogue qui mentionne le point de terminaison Responses. Remplacez YOUR_RESPONSES_MODEL avant de l’exécuter.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Exemple Chat Completions

Utilisez cet exemple uniquement si le modèle sélectionné dans le catalogue mentionne le point de terminaison OpenAI Chat. Remplacez YOUR_CHAT_MODEL avant de l’exécuter.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Vérifier le résultat

1. Lisez d’abord l’état HTTP. Un état 2xx signifie que la passerelle a accepté et terminé la requête HTTP, mais votre client doit encore examiner l’objet de réponse pour y trouver le résultat attendu.
2. Pour Responses, examinez l’état et la structure de sortie de la réponse. Pour Chat Completions, examinez la structure choices renvoyée. Ne supposez pas que les deux protocoles partagent la même structure de réponse.
3. Ouvrez le journal des requêtes ou de l’utilisation GetAPI.ONE et faites correspondre l’heure, le point de terminaison, le modèle et l’identifiant de requête lorsqu’il est disponible.

Streaming et nouvelles tentatives

Le streaming modifie le transport de la réponse et la gestion des événements ; sa prise en charge dépend du point de terminaison et du modèle sélectionnés. Commencez par une requête sans streaming, puis consultez la référence du protocole et la page du modèle avant d’ajouter des paramètres de flux.

• Ne réessayez pas automatiquement les erreurs d’authentification, de quota, d’autorisation ou de sélection de modèle.
• Avant de réessayer après une expiration du délai ou une défaillance en amont, déterminez si la requête initiale a pu être traitée et si l’opération peut être répétée en toute sécurité.
• Dans les applications, utilisez un nombre limité de nouvelles tentatives avec temporisation progressive ; conservez les identifiants de requête et les horodatages à des fins de diagnostic.

Branches d’erreur

• Liste de contrôle de dépannage
• Préparer un rapport pour l’assistance