Erstellen Sie Ihre erste API-Anfrage
Erstellen Sie einen ShareAI-API-Schlüssel, wählen Sie ein verfügbares Modell aus und senden Sie eine Chat-Anfrage von Ihrem Server mit Bearer-Authentifizierung.
Auf dieser Seite
Beginnen Sie hier, wenn Ihre Anwendung Anfragen mit einem API-Schlüssel aus Ihrem eigenen ShareAI-Arbeitsbereich stellen wird. Sie benötigen ein ShareAI-Konto, einen aktiven Schlüssel und Zugriff auf das Modell, das Sie ausführen möchten.
1. Erstellen Sie einen API-Schlüssel#
Öffnen ShareAI-Konsole und wählen Sie den Arbeitsbereich aus, der den Schlüssel und die Nutzung besitzen wird. Öffnen Sie API-Schlüssel, wählen Sie API-Schlüssel erstellen., geben Sie dem Schlüssel einen erkennbaren Namen und speichern Sie das Geheimnis in Ihrer Serverumgebung.


2. Wählen Sie ein Modell#
Öffnen Modelle und kopieren Sie die genaue Modellkennung, die dort angezeigt wird. Überprüfen Sie die aktuelle Verfügbarkeit und die Modell-/Provider-Beschränkungen für Ihren Schlüssel. Eine Kennung aus einem alten Tutorial garantiert nicht, dass die Kapazität heute verfügbar ist.
3. Senden Sie die Anfrage#
https://api.shareai.now/api/v1/chat/completionsGenerieren Sie eine Antwort mit einem verfügbaren Modell.
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel
Ersetzen MODEL_IDENTIFIER mit Ihrer ausgewählten Kennung. Setzen Sie SHAREAI_API_KEY in Ihrer Umgebung, bevor Sie das Beispiel ausführen.
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. Lesen Sie das Ergebnis#
Für eine erfolgreiche nicht-streaming Anfrage überprüfen Sie, ob "done" wahr ist, und lesen Sie die Assistentennachricht aus message.content. Überprüfen Sie sowohl den HTTP-Status als auch ein Fehlerobjekt im Body, bevor Sie es als erfolgreiche Ausführung behandeln. Ein "no-device"-Ergebnis kann derzeit als Fehlerobjekt mit HTTP 200 erscheinen.
Wenn die Anfrage fehlschlägt#
| Status | Nächster Schritt |
|---|---|
| 401 | Überprüfen Sie den Schlüssel, den Arbeitsbereich und den Authorization-Header. |
| 402 | Überprüfen Sie verfügbare Guthaben oder den anwendbaren Kontostand. |
| 403 | Überprüfen Sie erlaubte Modelle und Provider. |
| 429 | Warten Sie auf "Retry-After", falls vorhanden, und versuchen Sie es dann mit einer begrenzten Verzögerung erneut. |
| 503 | Überprüfen Sie die aktuelle Kapazität oder Verfügbarkeit des Dienstes; setzen Sie ein Wiederholungs-Limit. |
Nächste Schritte#
Referenz für Chat-Anfrage und -Antwort erklärt den unterstützten Body. Wenn jeder Kunde sein eigenes Konto autorisieren soll, folgen Sie Anwendung OAuth.
Zuletzt aktualisiert am 15. September 2026