Zum Hauptinhalt springen
Der Katalog enthält 61 Kontooperationen und get_capabilities. Sichtbar sind nur erlaubte Werkzeuge. Rechte und Eigentum werden bei jedem Aufruf erneut geprüft. Beginnen Sie mit dem Schnellstart. Außer bei get_capabilities stehen alle folgenden Felder in arguments.input. Schreibzugriffe benötigen zusätzlich arguments.idempotencyKey: 1–191 druckbare ASCII-Zeichen ohne Leerzeichen. Felder mit Standardwert sind optional. page_size und pageSize sind unterschiedliche Namen. Maßgeblich ist das aktuelle Schema aus tools/list. Erfolgreiche Ausgaben stehen in structuredContent und als JSON-Text in content. Der erste Aufruf liefert die folgende Hülle. Eine Wiederholung liefert replayed: true und einen kleinen receipt mit verfügbaren Kennungen, nicht das volle Originalergebnis oder einen Schlüssel-Geheimwert.
execution_pending (409) bedeutet, dass der erste Aufruf ungeklärt ist. execution_unknown (409) oder status: unknown bedeutet, dass die Wirkung bereits eingetreten sein kann. Erst get_execution, danach Aufgabe, Bestellung oder Kontoaktion prüfen. Diese Zustände niemals mit einem neuen Schlüssel umgehen. Eine abgeschlossene MCP-Ausführung kann noch eine offene Modellaufgabe oder Website-Bestätigung enthalten. Die Erfassung von Modellergebnissen ist auf 8 MiB und 300 Sekunden begrenzt. Bei Abbruch oder Überschreitung bleibt eine bekannte request_id im Ausführungsbeleg erhalten. Erst get_execution und die bestehende Anfrage oder Aufgabe prüfen; keinen weiteren kostenpflichtigen Request und keinen neuen Idempotenzschlüssel für einen ungeklärten Aufruf erzeugen. Eine Client-Trennung bedeutet nicht, dass eine angenommene Modellaufgabe abgebrochen wurde.

get_capabilities

Lesen · arguments: {} Nach der Initialisierung get_capabilities mit {} aufrufen und tools/list lesen. Die Antwort enthält audience: user, ownership: self, erlaubte scopes, Werkzeuge und oauth: false. Alle anderen persönlichen Werkzeuge verlangen ein input-Objekt, auch ohne fachliche Parameter.

list_models

Erforderliche Rechte: models:read · Lesen Ergebnis: Liefert items, total, page, page_size mit öffentlichen Modell-IDs, Preisen und Fähigkeiten.

get_model_schema

Erforderliche Rechte: models:read · Lesen Ergebnis: Liefert Parameter, Fähigkeiten und Preise eines erlaubten Modells.

get_api_guide

Erforderliche Rechte: models:read · Lesen Ergebnis: Liefert URLs, Authentifizierungsplatzhalter, Endpunkte und Hinweise zur Aufgabenabfrage für format.

chat_completion

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

create_response

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

create_message

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

generate_content

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

generate_image

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

generate_image_sync

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

edit_image

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz. Vor dem Lesen von Dateiinhalten werden Eigentum, Bereitschaft, Anzahl und Größe geprüft. Jede Dateireferenz zählt für die Grenzen der Operation, auch wiederholte IDs. edit_image: höchstens 20 Dateien über alle Felder, davon höchstens eine mask; 50 MiB pro Datei / 100 MiB insgesamt. Die Array-Grenzen je Feld aus dem Eingabeschema gelten weiterhin.

generate_video

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

generate_video_sync

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

moderate_content

Erforderliche Rechte: models:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert HTTP-status, request_id, credits_charged, content_type sowie response oder gesammelte events. Asynchrone Aufgaben mit get_task prüfen; Annahme bedeutet noch keinen Abschluss. body enthält den gesamten unterstützten HTTP-JSON-Request. generate_content benötigt das äußere model; sonst gilt body.model. files ordnet Bildbearbeitungsfelder eigenen Datei-ID-Arrays zu und benötigt files:write. client_request_id ist für Videozuordnung. Siehe HTTP-Referenz.

upload_image

Erforderliche Rechte: models:invoke, files:write · Schreiben; idempotencyKey erforderlich Ergebnis: Veröffentlicht JPEG, PNG oder WebP und liefert die Modell-Eingabe-URL in der Standardantwort. Die URL ist teilbar. Vor dem Lesen von Dateiinhalten werden Eigentum, Bereitschaft, Anzahl und Größe geprüft. Jede Dateireferenz zählt für die Grenzen der Operation, auch wiederholte IDs. upload_image: eine Datei mit höchstens 50 MiB.

upload_media

Erforderliche Rechte: files:write · Schreiben; idempotencyKey erforderlich Ergebnis: Veröffentlicht Bilder, Videos oder Audio und liefert URLs. Die Veröffentlichung macht sie teilbar und ist ein eigener Schritt nach dem privaten Upload. Vor dem Lesen von Dateiinhalten werden Eigentum, Bereitschaft, Anzahl und Größe geprüft. Jede Dateireferenz zählt für die Grenzen der Operation, auch wiederholte IDs. upload_media: höchstens 20 Dateien / 250 MiB insgesamt.

get_task

Erforderliche Rechte: models:invoke · Lesen Ergebnis: Status und Ergebnis einer eigenen bestehenden Aufgabe, ohne neue Aufgabe oder erneute Berechnung.

list_utilities

Erforderliche Rechte: models:read · Lesen Ergebnis: items mit id, Name, Beschreibung, Methode, body_kind, response_kind, fields, limits und access.

get_utility_schema

Erforderliche Rechte: models:read · Lesen Ergebnis: Felder, Dateitypen, Standardwerte, Größenlimits und Zugangsvoraussetzungen des Hilfsprogramms.

run_utility

Erforderliche Rechte: utilities:invoke · Schreiben; idempotencyKey erforderlich Ergebnis: Liefert status und JSON-result oder ein temporäres artifact für binäre/große Ergebnisse. Dateien und Nicht-JSON-Ausgaben benötigen zusätzlich files:write; Kontingente und Zugangsvoraussetzungen gelten weiterhin. Vor dem Lesen von Dateiinhalten werden Eigentum, Bereitschaft, Anzahl und Größe geprüft. Jede Dateireferenz zählt für die Grenzen der Operation, auch wiederholte IDs. run_utility: Datei-, Einzelgrößen- und Gesamtlimits aus get_utility_schema gelten. Die feste Obergrenze beträgt 250 MiB insgesamt, auch wenn der Katalog mehr zulässt.

begin_upload

Erforderliche Rechte: files:write · Schreiben; idempotencyKey erforderlich Ergebnis: Dateimetadaten: id, name, mime_type, size, status, expires_at, sha256. Danach id als file_id verwenden.

upload_chunk

Erforderliche Rechte: files:write · Schreiben; idempotencyKey erforderlich Ergebnis: file_id, index, received: true. Nach Base64-Dekodierung höchstens 1 MiB; gleicher Index verlangt identische Bytes.

finish_upload

Erforderliche Rechte: files:write · Schreiben; idempotencyKey erforderlich Ergebnis: Geprüfte Metadaten mit status: ready und SHA-256. Alle aufeinanderfolgenden Teile und die exakt deklarierte Größe sind erforderlich.

get_artifact

Erforderliche Rechte: files:write · Lesen Ergebnis: Ohne offset: Metadaten und download_url mit Website-Anmeldung. Mit offset: Base64-data, offset, next_offset; null bedeutet Ende. Standardlänge: 1 MiB.

list_api_keys

Erforderliche Rechte: keys:read · Lesen Ergebnis: Paginierte Einstellungen und Präfixe, ohne Geheimwerte.

get_api_key

Erforderliche Rechte: keys:read · Lesen Ergebnis: Einstellungen des eigenen Schlüssels ohne Geheimwert.

create_api_key

Erforderliche Rechte: keys:write · Schreiben; idempotencyKey erforderlich Ergebnis: Nur Metadaten des neuen Schlüssels. Geheimwert erst nach Website-Bestätigung. purpose ist eine Bezeichnung ohne MCP-Rechte.

update_api_key

Erforderliche Rechte: keys:write · Schreiben; idempotencyKey erforderlich Ergebnis: Aktualisierte Einstellungen; mindestens ein Feld zusätzlich zu key_id.

set_api_key_status

Erforderliche Rechte: keys:write · Schreiben; idempotencyKey erforderlich Ergebnis: Einstellungen mit Status active oder disabled.

delete_api_key

Erforderliche Rechte: keys:write · Schreiben; idempotencyKey erforderlich Ergebnis: Bestätigte id, status: deleted, deletedAt. Gelöschte Schlüssel können nicht reaktiviert werden.

start_reveal_key_action

Erforderliche Rechte: keys:secrets · Schreiben; idempotencyKey erforderlich Ergebnis: Ausstehende Aktion mit id, confirmation_url, expires_at und Wirkung, ohne Geheimwert.

reveal_api_key

Erforderliche Rechte: keys:secrets · Schreiben; idempotencyKey erforderlich Ergebnis: Nach Bestätigung einmalig action_id, key_id und Klartext-key. Wiederholungen geben den Geheimwert nicht erneut aus.

get_profile

Erforderliche Rechte: account:read · Lesen Ergebnis: Eigenes Profil, aktuelles Abo und freeApi-Berechtigung, RPM und Stapelzugriff. Keine Felder: input: {} verwenden.

get_account_capabilities

Erforderliche Rechte: account:read · Lesen Ergebnis: scopes, bound_api_key_id, free_api-Stufe/RPM und bestätigungspflichtige Aktionen. Keine Felder: input: {} verwenden.

update_profile

Erforderliche Rechte: account:write · Schreiben; idempotencyKey erforderlich Ergebnis: Aktualisiertes Profil. name oder image erforderlich; leerer Bildwert entfernt das Bild. HTTP(S)- oder unterstützte Bild-data-URL möglich.

list_login_records

Erforderliche Rechte: account:read · Lesen Ergebnis: Letzte Anmeldungen in items mit Zeit, Methode, IP und Ort, ohne Sitzungstoken.

get_integration_config

Erforderliche Rechte: account:read · Lesen Ergebnis: API- und MCP-URLs nur mit Platzhalter-Zugangsdaten. Keine Felder: input: {} verwenden.

start_account_action

Erforderliche Rechte: account:write · Schreiben; idempotencyKey erforderlich Ergebnis: Ausstehende Website-Bestätigung. Passwortänderung und Kontolöschung erfolgen auf der Website.

get_account_action

Erforderliche Rechte: account:read · Lesen Ergebnis: status, Bestätigungslink, Ablaufzeit, Ziel und Abschlusszeit der eigenen Aktion.

get_balance

Erforderliche Rechte: billing:read · Lesen Ergebnis: Konto-balance und gegebenenfalls Budget und Restguthaben des gebundenen Schlüssels. Keine Felder: input: {} verwenden.

list_credit_transactions

Erforderliche Rechte: billing:read · Lesen Ergebnis: Paginierte Guthabenbuchungen mit Beträgen, Richtung, Status, Datum und Bestellung oder Abo.

list_orders

Erforderliche Rechte: billing:read · Lesen Ergebnis: Paginierte Bestellungen mit Status, Betrag, Währung, Produkt und Zahlungsterminen. Erstellung ist kein Zahlungsnachweis.

list_billing_products

Erforderliche Rechte: billing:read · Lesen Ergebnis: Aktuelle Produkt-IDs, Preise, Währungen und Credits. Zur Zahlung eine gelieferte productId als product_id verwenden. Keine Felder: input: {} verwenden.

create_checkout

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: checkout_url und order_no. Der Nutzer bezahlt auf der Website; danach get_payment_status prüfen.

get_payment_status

Erforderliche Rechte: billing:read · Lesen Ergebnis: Zahlungsstatus, Betrag, Währung und Zahlungszeit der eigenen Bestellung, gegebenenfalls mit Prüfstatus.

get_invoice

Erforderliche Rechte: billing:read, files:write · Schreiben; idempotencyKey erforderlich Ergebnis: order_no und temporäre PDF-file. Verfügbarkeit hängt von der Zahlungsart ab; Dateierstellung verlangt einen Idempotenzschlüssel.

resend_invoice

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: order_no, Ziel-email, sent: true. Sendet eine echte Rechnungsmail an die Bestelladresse; nur auf Wunsch ausführen.

list_subscriptions

Erforderliche Rechte: billing:read · Lesen Ergebnis: Paginierte Abodaten, Produkt, Status, Abrechnungszeitraum und Kündigungsdaten.

get_current_subscription

Erforderliche Rechte: billing:read · Lesen Ergebnis: subscription-Metadaten oder null, wenn kein aktuelles Abo besteht. Keine Felder: input: {} verwenden.

cancel_subscription

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: Startet eine Bestätigung für ein Abo. Erst nach Website-Bestätigung und geprüftem Abschluss ist es gekündigt.

list_redemptions

Erforderliche Rechte: billing:read · Lesen Ergebnis: Eigene letzte Einlösungen in items.

redeem_code

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: Hinzugefügte credits und redeemed: true. Ungültige oder verbrauchte Codes ergeben einen Fehler.

get_credit_alert

Erforderliche Rechte: billing:read · Lesen Ergebnis: Schwelle, E-Mail-/Webhook-Aktivierung, webhookConfigured und Häufigkeit, ohne geheime Webhook-URL. Keine Felder: input: {} verwenden.

update_credit_alert

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: Aktualisierte Einstellungen; mindestens ein Feld angeben. Webhooks benötigen öffentliche HTTP(S)-URLs.

test_credit_alert

Erforderliche Rechte: billing:write · Schreiben; idempotencyKey erforderlich Ergebnis: Sendet eine echte Guthabenwarnung über delivery; liefert Art, Guthaben, Schwelle und verfügbaren HTTP-Status. Nur auf Wunsch ausführen.

get_overview

Erforderliche Rechte: usage:read · Lesen Ergebnis: Übersicht für timezoneOffset: Nutzer, Guthaben, Schlüssel, Nutzung, letzte Aktivitäten und Abo.

list_usage

Erforderliche Rechte: usage:read · Lesen Ergebnis: Paginierte aufbewahrte Anfragen und UTC-window; unbekannte Cache-Token bleiben null. Nutzungsfilter verwenden ISO-8601-Zeitstempel mit Zeitzone, from einschließlich und to ausschließlich. Standard: letzte 30 Tage, maximal 366. Nur aufbewahrte Datensätze; fehlende Tage beweisen keine Nullnutzung. get_overview.timezoneOffset nutzt JavaScript-getTimezoneOffset in Minuten (UTC minus Ortszeit), Standard 0. Listen und Gruppierungen bleiben UTC.

get_usage_detail

Erforderliche Rechte: usage:read · Lesen Ergebnis: Status, Dauer und Abrechnung der eigenen Anfrage. Inhalt erfordert include_content: true, usage:content und aktivierte Inhaltsaufzeichnung am Schlüssel.

diagnose_request

Erforderliche Rechte: usage:read · Lesen Ergebnis: request_id, task_id, Status, tatsächlicher Fehlercode, Abrechnung/Erstattung und Hinweise. Kein Modellaufruf oder automatischer Neuversuch.

summarize_usage

Erforderliche Rechte: usage:read · Lesen Ergebnis: totals, groups, group_by, UTC-window für alle passenden aufbewahrten Anfragen. Fehlende Tage werden ausgelassen; cachedTokens ist unbekannt. Erstattungen umfassen nur verknüpfte asynchrone Aufgaben. Nutzungsfilter verwenden ISO-8601-Zeitstempel mit Zeitzone, from einschließlich und to ausschließlich. Standard: letzte 30 Tage, maximal 366. Nur aufbewahrte Datensätze; fehlende Tage beweisen keine Nullnutzung. get_overview.timezoneOffset nutzt JavaScript-getTimezoneOffset in Minuten (UTC minus Ortszeit), Standard 0. Listen und Gruppierungen bleiben UTC. In summarize_usage sind creditsCharged und netCreditsCharged die aufbewahrte Nettobelastung. linkedRefundCredits umfasst nur bekannte Erstattungen verknüpfter asynchroner Aufgaben. knownGrossCredits addiert diese zur Nettobelastung und ist keine vollständige Bruttoausgabe. totalTokens, averageLatencyMs, pending, processing beziehen sich auf passende aufbewahrte Anfragen.

list_executions

Erforderliche Rechte: account:read · Lesen Ergebnis: Paginierte Ausführungsbelege mit Operation, Status, Kennungen, Fehlercode und Zeit.

get_execution

Erforderliche Rechte: account:read · Lesen Ergebnis: Ein eigener Ausführungsbeleg zur Klärung von pending oder unknown; ohne vollständige Ausgabe oder Geheimwerte.

Hilfsprogramme: 32 Funktionen

Slug als run_utility.input.utility nutzen. Zuerst get_utility_schema lesen: fields beschreibt Namen, Typen, Pflichtwerte, Standardwerte, Mehrfachdateien und Formate; limits und access beschreiben Größe, Anzahl und Voraussetzungen. Stapelschemas nicht aus Einzeldateiversionen ableiten.