Erstellen Sie Ihre erste API-Anfrage

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#

Ersetzen MODEL_IDENTIFIER mit Ihrer ausgewählten Kennung. Setzen Sie SHAREAI_API_KEY in Ihrer Umgebung, bevor Sie das Beispiel ausführen.

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 '{
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "model": "MODEL_IDENTIFIER",
  "messages": [
    {
      "role": "user",
      "content": "Explain what ShareAI does in one sentence."
    }
  ],
  "stream": false
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, '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))

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 = {
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "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#

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.

Modellidentität und Ausführungsanbieter#

Kopieren Sie die genaue, auf dem Creator basierende Modellkennung von Modelle. Wählen Sie die Infrastruktur separat mit dem optionalen provider Objekt aus. Standardmäßig werden berechtigte Anbieter nach Preis sortiert, beginnend mit dem niedrigsten. Anbieter auswählen oder konsultieren Sie die vollständige Richtlinienreferenz.