Guide API : OpenAI GPT

Modèles OpenAI GPT publiés

Les noms, identifiants de routage exacts, versions et états d’inférence proviennent du registre de modèles activé, lorsqu’il est disponible. Un identifiant vide signifie que le catalogue n’a publié aucune valeur de routage ; ne la déduisez pas du nom du modèle.

Développeur

OpenAI

Accès pour les nouveaux clients

Disponible

Envoyer votre première requête

Envoyez des requêtes HTTPS à l’URL de base ci-dessous. Utilisez POST /chat/completions pour le chat textuel compatible avec OpenAI ou POST /messages pour Claude Messages. Choisissez le protocole dans l’atelier de modèles et reprenez son URL exacte ainsi que son format JSON.

URL de base de l’API: https://fusionpointai.com/api/v1

Créez ou gérez une clé API client dans les paramètres de clés API de votre compte. Envoyez-la comme jeton bearer et conservez-la sur un serveur de confiance ; ne l’intégrez ni au code du navigateur, ni au contrôle de version, ni à un journal public.

La clé doit avoir la portée ai:inference et l’accès à l’abonnement client concerné. La clé API publique n’est pas le mot de passe du compte et ne doit pas être partagée.

Ces exemples utilisent le point de terminaison enregistré de complétion de chat JSON et les clients Python et Node.js compatibles avec OpenAI. Stockez la clé dans la variable d’environnement FUSIONPOINTAI_API_KEY. Remplacez la valeur du modèle uniquement par un identifiant exact répertorié ci-dessus.

# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai

# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY

curl 'https://fusionpointai.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "gpt-6.1-sol",
    "messages": [
        {
            "role": "user",
            "content": "Summarize this in one sentence."
        }
    ],
    "temperature": 0.7,
    "max_tokens": 300
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
    base_url="https://fusionpointai.com/api/v1",
)

response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "Summarize this in one sentence."}],
    temperature=0.7,
    max_tokens=300,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUSIONPOINTAI_API_KEY,
  baseURL: "https://fusionpointai.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · Contrat de requête et de réponse

Le point de terminaison accepte le format JSON. Les messages sont envoyés dans l’ordre ; chacun comporte un rôle pris en charge et un contenu de type chaîne. Les paramètres de génération facultatifs doivent respecter les limites de validation ci-dessous. La réponse est un objet JSON chat.completion contenant des choix et, si le fournisseur les renvoie, des données d’utilisation des jetons.

Structure de la réponse

Une réponse réussie contient id, object (chat.completion), created, model et choices. Un choix contient son index, un message assistant et finish_reason. Le nombre de jetons peut figurer dans usage. Des limites propres au fournisseur peuvent s’appliquer même si la requête passe la validation de la passerelle.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "gpt-6.1-sol",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "A concise summary of the supplied text."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 10,
        "total_tokens": 22
    }
}

Accès, limites et bonnes pratiques d’utilisation

Les abonnements client actifs ne décomptent pas les requêtes ni les jetons d’un quota ; les clés sandbox sont limitées au volume mensuel publié. Cette règle relative à l’abonnement est indépendante des limites techniques du modèle et des systèmes amont.

• La taille de la fenêtre de contexte, la sortie maximale, les fonctionnalités de requête prises en charge et les contrôles temporaires du trafic amont varient. Consultez les informations sur le fournisseur et le modèle avant d’envoyer du trafic de production.
• Le point de terminaison applique une limite applicative de 60 requêtes par minute pour chaque identité de limitation concernée. Une réponse HTTP 429 peut aussi signaler des contrôles temporaires du trafic amont ; réessayez avec un délai progressif plutôt qu’en boucle serrée.
• Utilisez HTTPS, conservez les clés côté serveur, n’accordez que la portée d’inférence requise et révoquez rapidement toute clé susceptible d’avoir été exposée.
• Chat Completions traite du texte de façon synchrone. Claude Messages prend séparément en charge les blocs de contenu natifs, les outils et le flux SSE lorsque le modèle sélectionné le permet. Les autres points de terminaison des fournisseurs ne font pas partie de ces contrats.

Accès au fournisseur et conditions liées au compte

Authentifiez-vous avec une clé API client dotée de la portée ai:inference et rattachée à un compte ayant accès à ce service. Le catalogue indique si de nouveaux clients sont actuellement acceptés. Il n’accorde aucun accès, ne crée pas d’abonnement et ne remplace pas les autorisations du compte ou de la clé.

Erreurs et dépannage

Les erreurs de validation et les résultats inutilisables du fournisseur renvoyés par le point de terminaison sont présentés dans un objet JSON error comprenant message, type et code ; les erreurs de validation peuvent aussi préciser les champs concernés. N’incluez pas de clés API ni le contenu privé d’invites dans vos tickets d’assistance.

Les erreurs de validation de requête et les échecs du fournisseur renvoyés par l’opération de chat utilisent un objet error. Le middleware d’authentification, de portée et de limitation peut à la place renvoyer un champ message à la racine. Examinez ensemble le statut et le corps de la réponse.

Questions fréquentes