Effectuez votre première requête API
Créez une clé API ShareAI, choisissez un modèle disponible et envoyez une requête de chat depuis votre serveur avec une authentification Bearer.
Sur cette page
Commencez ici lorsque votre application effectuera des requêtes en utilisant une clé API depuis votre propre espace de travail ShareAI. Vous avez besoin d'un compte ShareAI, d'une clé active et d'un accès au modèle que vous souhaitez exécuter.
1. Créez une clé API#
Ouvrir Console ShareAI et sélectionnez l'espace de travail qui possédera la clé et l'utilisation. Ouvrez Clés API, choisissez Créer une clé API, donnez à la clé un nom reconnaissable et enregistrez le secret dans l'environnement de votre serveur.


2. Choisissez un modèle#
Ouvrir Modèles et copiez l'identifiant exact du modèle affiché à cet endroit. Vérifiez la disponibilité actuelle et les restrictions du modèle/fournisseur sur votre clé. Un identifiant dans un ancien tutoriel ne garantit pas que la capacité est disponible aujourd'hui.
3. Envoyez la requête#
https://api.shareai.now/api/v1/chat/completionsGénérez une réponse en utilisant un modèle disponible.
- URL de base
https://api.shareai.now- Authentification
- Clé API Bearer
Remplacer MODEL_IDENTIFIER avec l'identifiant sélectionné. Configurez SHAREAI_API_KEY dans votre environnement avant d'exécuter l'exemple.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. Lisez le résultat#
Pour une requête non-streaming réussie, vérifiez que done est true et lisez le message de l'assistant depuis message.content. Vérifiez à la fois le statut HTTP et tout objet d'erreur dans le corps avant de le traiter comme une réussite. Un résultat sans appareil peut actuellement arriver sous forme d'objet d'erreur avec HTTP 200.
Si la requête échoue#
| Statut | Prochaine étape |
|---|---|
| 401 | Vérifiez la clé, l'espace de travail et l'en-tête Authorization. |
| 402 | Vérifiez les crédits disponibles ou le solde applicable. |
| 403 | Vérifiez les modèles et fournisseurs autorisés. |
| 429 | Attendez Retry-After lorsqu'il est présent, puis réessayez avec un délai limité. |
| 503 | Vérifiez la capacité actuelle ou la disponibilité du service ; maintenez une limite de tentatives. |
Prochaines étapes#
Référence des requêtes et réponses de chat explique le corps pris en charge. Si chaque client doit autoriser son propre compte, suivez OAuth d'application.
Dernière mise à jour le 15 septembre 2026