AI

Nutze die AI-API in deinen Apps und Automatisierungen mit einem eigenen API-Schlüssel, Text- und Bildeingaben, Streaming und strukturierten Antworten.

Link: AI

Anmelden/Registrieren

1. Öffne Anmelden.
2. Melde dich mit Apple, Google oder einem Code per E-Mail an. Neue Nutzer werden automatisch registriert.
3. Mit demselben Konto verwaltest du deine AI-Dienste, dein Guthaben und deine Abrechnungsdokumente.

Guthaben aufladen

1. Öffne Zahlungsmethoden und lade Guthaben mit einer verfügbaren Methode auf.
2. Halte genügend Guthaben für den vor dem Kauf angezeigten Monatspreis und künftige Verlängerungen bereit.

Dienst kaufen

1. Öffne AI.
2. Gib einen Namen für deine App oder Integration ein und drücke Weiter.
3. Prüfe den Monatspreis und bestätige die Erstellung. Öffne den AI-Auftrag im Profil, um den API-Schlüssel und das Limit für Anfragen pro Minute zu sehen.

Anwendung verbinden

Setze AI_API_KEY sicher auf den erzeugten Schlüssel. Bewahre ihn auf deinem Server auf; bette ihn nicht in öffentlich zugänglichen Website-Code oder mobile App-Pakete ein.

Verwende bei Clients mit konfigurierbarer API-Basis-URL https://yoosolutions.com/api/v1/ai und das Modell ai. Der deinem Auftrag zugewiesene Anbieter und das Modell verarbeiten die Anfrage; die verfügbaren Funktionen hängen von diesem Modell ab.

curl --request POST 'https://yoosolutions.com/api/v1/ai/chat/completions' \
  --header "Authorization: Bearer ${AI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model":"ai","messages":[{"role":"user","content":"Fasse den Fortschritt dieses Projekts zusammen."}]}'

Die Antwort steht unter choices[0].message.content in der JSON-Antwort.

Unterstützte Anfragen

• Sende Text in messages. Nutzernachrichten können auch image_url-Teile mit JPEG-, PNG- oder WebP-Daten in base64 enthalten; externe Bild-URLs werden abgewiesen.
• Verwende response_format mit text, json_object oder json_schema. Die Ausgabe nach einem JSON-Schema erfordert strict: true.
• Setze stream: true für Streaming. Setze zusätzlich stream_options.include_usage: true, um Nutzungsdaten einzuschließen.
• Steuere die Antwortlänge mit max_completion_tokens. Falls store angegeben wird, muss es false sein; andere nicht dokumentierte Anfragefelder werden abgewiesen.
• Anfragen speichern keinen Gesprächszustand. Füge den benötigten Gesprächsverlauf für jede Anfrage in messages ein.

Limits und Abrechnung

• Anfragen sind auf 20 MiB, 120 Sekunden und 16384 Ausgabetokens begrenzt; standardmäßig sind es 4096 Ausgabetokens.
• Das im Auftrag angezeigte Limit für Anfragen pro Minute gilt in einem gleitenden Fenster von 60 Sekunden und bleibt beim Zurücksetzen des Schlüssels bestehen.
• Verlängerungen werden vom Guthaben abgebucht. Wird eine Verlängerung nicht bezahlt, bleibt der API-Zugang bis zur erfolgreichen Zahlung gesperrt. Abrechnungsverlauf, Rechnungen und Belege sind im Profil verfügbar.

Dienst verwalten

• Bearbeiten ändert den Namen des Dienstes, ohne Schlüssel, Modell oder Limit zu ändern.
• Zurücksetzen erzeugt einen neuen API-Schlüssel und widerruft den alten sofort. Aktualisiere den Schlüssel in deiner Anwendung; das Zurücksetzen setzt das Anfragelimit nicht zurück.
• Entfernen widerruft den API-Zugang und beendet künftige Abbuchungen für den Dienst.

Fehlerbehebung

• 400: Prüfe Anfragefelder, das Modell ai und das Nachrichtenformat.
• 401: Prüfe den Bearer-Schlüssel und aktualisiere ihn nach dem Zurücksetzen.
• 402: Prüfe Guthaben und Verlängerungszahlung im Profil.
• 429: Warte vor einem erneuten Versuch die im Header Retry-After angegebene Anzahl an Sekunden.
• 503: Das zugewiesene Modell oder der Anbieter ist nicht verfügbar. Versuche es später erneut oder kontaktiere den Support.