Schnellstart der gemeinsamen API

Die gemeinsame API bietet grundlegende Hilfsdienste zur Verwaltung deines 97AI.PRO-Kontos und zum Umgang mit generierten Inhalten. Diese APIs helfen dir, die Credit-Nutzung zu überwachen und effizient auf generierte Dateien zuzugreifen.

Alle API-Anfragen erfordern eine Authentifizierung per Bearer-Token. Hol dir deinen API-Schlüssel auf der Seite zur API-Schlüsselverwaltung und bewahre ihn sicher auf.

https://97ai.97claude.com

Authorization-Header

Authorization: Bearer YOUR_API_KEY

Zwei grundlegende Vorgänge: prüfe dein Guthaben und lade dann die Ergebnisdateien einer abgeschlossenen Aufgabe herunter.

curl -X GET "https://97ai.97claude.com/api/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

Antwortbeispiel

{
  "credits": 1950
}

Wenn eine Aufgabe abgeschlossen ist, gibt GET /api/generate/{taskId} resultUrls zurück – direkte, herunterladbare URLs für die generierten Medien:

curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"
# → { "state": "success", "resultUrls": ["https://…/out.jpg"], … }

curl -o out.jpg "https://…/out.jpg"

Kontoguthaben prüfen – GET /api/credits

• Erhalte das Guthaben in Echtzeit
• Keine Parameter nötig; sofortige Antwort
• Unverzichtbar für Nutzungsüberwachung und Guthaben-Schwellenwarnungen

Aufgabenergebnisse – GET /api/generate/{taskId}

• resultUrls deckt alle generierten Dateitypen ab (Bilder, Videos, Audio usw.)
• URLs sind direkt herunterladbar – kein zusätzlicher Austauschschritt nötig
• Dateien werden 14 Tage aufbewahrt und dann automatisch gelöscht

Ein automatisierter Client zur Guthabenüberwachung:

class Ai97Client {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://97ai.97claude.com';
  }
  async getCredits() {
    const res = await fetch(this.baseUrl + '/api/credits', {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    if (!res.ok) throw new Error('Failed to get credits: ' + res.statusText);
    return (await res.json()).credits;
  }
  async getResultUrls(taskId) {
    const res = await fetch(this.baseUrl + '/api/generate/' + taskId, {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    const j = await res.json();
    return j.state === 'success' ? j.resultUrls : null;
  }
  async checkCreditsAndWarn(threshold = 10) {
    const credits = await this.getCredits();
    if (credits < threshold) { console.warn('Low credits: ' + credits); return false; }
    return true;
  }
}

Häufige Fehler: 401 Nicht autorisiert (fehlender/ungültiger Schlüssel), 402 Unzureichendes Guthaben, 403 Verboten (Schlüssel für das Modell nicht zugelassen), 404 Nicht gefunden (unbekannte taskId), 500 Serverfehler.

E-Mail: [email protected] · Dokumentation: https://97ai.97claude.com/docs · API-Status: prüfe die Echtzeit-Verfügbarkeit auf jeder Modellseite.