Créez une complétion de chat
Envoyez une requête de complétions de chat ShareAI avec une clé API Bearer et comprenez les champs pris en charge pour le modèle, les messages et le flux.
Sur cette page
https://api.shareai.now/api/v1/chat/completionsExécutez une requête de chat en utilisant le modèle sélectionné.
- URL de base
https://api.shareai.now- Authentification
- Clé API Bearer
Il s'agit du chemin d'intégration par défaut pour les requêtes payées et autorisées par l'espace de travail de votre clé API. Les restrictions de modèle et de fournisseur de la clé s'appliquent à l'allocation, y compris les chemins de secours autorisés.
Corps de la requête#
| Champ | Type | Signification |
|---|---|---|
model | chaîne de caractères, requis | Identifiant exact du modèle disponible. Copiez-le depuis Modèles. |
messages | tableau | Messages de conversation contenant le rôle et le contenu. |
stream | booléen | false renvoie un résultat JSON unique ; true demande des événements envoyés par le serveur. |
Utilisez le contenu des messages textuels. Envoyez des rôles tels que system, user et assistant selon ce qui est approprié pour la conversation. Incluez l'historique de la conversation que vous souhaitez que le modèle utilise ; ne supposez pas que les requêtes partagent une conversation stockée.
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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], '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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
Réponse#
Un résultat non diffusé complété définit done à true et renvoie le texte généré à message.content. Le niveau supérieur contient également done_reason et consumption_type. La diffusion utilise un format différent, chat-completion-chunk. Ne supposez pas que le résultat non diffusé contient un tableau de choix au format OpenAI.
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
Voici un exemple de résultat complété ; consumption_type décrit le mode d'allocation réel. Vérifiez une erreur au niveau supérieur même lorsque le statut HTTP est 200. Un résultat sans appareil utilise actuellement error.code = no_device avec HTTP 200.
Restrictions sur les modèles et les fournisseurs#
Une clé peut être limitée à des modèles spécifiques et à des fournisseurs d'exécution. Si l'accès est refusé, examinez les informations de la clé et mettez à jour la clé dans la Console uniquement si l'espace de travail propriétaire a l'intention d'accorder cet accès.
Diffusion ou autorisation client#
Dernière mise à jour le 15 septembre 2026