GetAPI.ONE

Appeler GetAPI.ONE depuis Python

Installez le SDK Python officiel OpenAI, dirigez-le vers l’URL de base ONE, effectuez une requête Responses contrôlée et vérifiez le résultat sans placer d’identifiants dans le code source.

Préparer le projet et l’identifiant

Python 3.10 ou version ultérieure et un environnement virtuel.
Une clé API GetAPI.ONE activée avec une expiration et un quota choisis délibérément.
Un identifiant de modèle copié du catalogue actuel dont le point de terminaison déclaré est Responses.

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Configurer et envoyer la requête

Définissez GETAPI_ONE_API_KEY dans l’environnement du processus ; ne collez pas la clé dans le fichier.
Créez le client avec https://www.getapi.one/v1 comme base_url.
Remplacez la valeur de substitution bien visible par un identifiant exact du catalogue actuel déclarant Responses.
N’exécutez le script que lorsque vous acceptez que la requête puisse être facturée.
La première vérification désactive les nouvelles tentatives du SDK. N’ajoutez que des tentatives limitées et observables après avoir déterminé les opérations répétables en toute sécurité.

python main.py

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

Comprendre le contrat

Champ	Valeur requise
base_url	https://www.getapi.one/v1
api_key	GETAPI_ONE_API_KEY depuis l’environnement serveur
model	Identifiant exact du catalogue actuel
méthode	client.responses.create

Vérifier le résultat attendu

Le processus se termine sans erreur d’authentification ni de point de terminaison.
response.output_text contient la réponse courte demandée.
La console GetAPI.ONE affiche un enregistrement correspondant de requête ou d’utilisation pour la clé.

Corriger les erreurs courantes

Symptôme	Contrôle
401 ou erreur d’authentification	Copiez de nouveau la clé ONE, confirmez qu’elle est activée et vérifiez que la variable d’environnement appartient à ce processus.
404	Conservez exactement un /v1 dans base_url et n’utilisez la méthode Responses que pour un modèle déclarant ce point de terminaison.
Modèle indisponible ou incompatible	Copiez de nouveau l’identifiant exact depuis le catalogue actuel ; ne déduisez aucun alias.

Préserver la sécurité de l’intégration

Exécutez le SDK uniquement dans du code d’outillage local ou serveur de confiance, jamais dans du JavaScript de navigateur.
Excluez les fichiers .env du contrôle de version et faites immédiatement tourner une clé si elle est exposée.
Utilisez des clés distinctes et limitées pour le développement et la production.

Étapes suivantes

Diffuser une réponseGérer les événements du cycle de vie SSE et les résultats terminaux.
Choisir un modèleFaire correspondre la tâche au contrat du point de terminaison du catalogue.