Liste des Verbrauchspunkte für Workflow-Ausführungen

Liste des Verbrauchspunkte für Workflow-Ausführungen

Über diese Schnittstelle können die Details des Punkteverbrauchs für eine bestimmte Workflow-Ausführung innerhalb eines Zeitraums abgerufen werden, nach runId aggregiert, es werden maximal Daten der letzten 30 Tage zurückgegeben.

Anfragemethode

GET

Aufrufadresse

https://api.gptbots.ai/v1/account/workflow/run/credits

Authentifizierung beim Aufruf

Details finden Sie in der Beschreibung der Authentifizierungsmethoden in API Übersicht.

Aufruffrequenz

Diese Schnittstelle wird auf das Kontingent „Statistik-APIs“ des Organisationspakets pro Minute angerechnet und teilt sich dieses Kontingent mit anderen Statistik-APIs (einschließlich organisationsweiter Statistik-APIs). Bei Überschreitung wird 40008 zurückgegeben.

Anfrage

Anfragebeispiel

curl -X GET 'https://api.gptbots.ai/v1/account/workflow/run/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \ -H 'Authorization: Bearer your_apikey'
                      
                      curl -X GET 'https://api.gptbots.ai/v1/account/workflow/run/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \
  -H 'Authorization: Bearer your_apikey'

                    
Dieser Codeblock im schwebenden Fenster

Anforderungsheader

Feld Typ Beschreibung
Authorization Bearer ${token} Verwenden Sie Authorization: Bearer ${token} zur Aufrufauthentifizierung. Bitte holen Sie sich den Schlüssel auf der API-Schlüsselseite als Token.

Anforderungsparameter

Feld Typ Pflicht Beschreibung
start_time long Ja Abfrage-Beginnzeit, Millisekunden-Zeitstempel.
end_time long Ja Abfrage-Endzeit, Millisekunden-Zeitstempel. Der Abstand zwischen start_time und end_time darf 30 Tage nicht überschreiten.
page int Nein Seitenzahl, Standardwert ist 1.
page_size int Nein Anzahl der Einträge pro Seite, Standardwert ist 20, maximal 100.
run_id string Nein Workflow-Ausführungs-ID.

Antwort

Antwortbeispiel

{ "list": [ { "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "run_start_time": 1774838000000, "chat": 2.10, "anonymization": 0, "asr": 0.50, "tts": 0, "rerank": 0.30, "database_processing": 0, "tool_call": 0.80, "knowledge_doc_indexing": 0, "question_tag": 0, "total": 3.70 } ], "total": 1, "page": 1, "page_size": 20, "start_time": 1774837924000, "end_time": 1775183447000 }
                      
                      {
    "list": [
        {
            "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "run_start_time": 1774838000000,
            "chat": 2.10,
            "anonymization": 0,
            "asr": 0.50,
            "tts": 0,
            "rerank": 0.30,
            "database_processing": 0,
            "tool_call": 0.80,
            "knowledge_doc_indexing": 0,
            "question_tag": 0,
            "total": 3.70
        }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "start_time": 1774837924000,
    "end_time": 1775183447000
}

                    
Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld Typ Beschreibung
list Liste Liste der Details zum Punkteverbrauch.
run_id string Workflow-Ausführungs-ID.
run_start_time long Startzeit der Workflow-Ausführung (Millisekunden-Zeichenfolge), null, wenn der Ausführungsdatensatz gelöscht wurde.
chat Dezimal Punkteverbrauch für das Gespräch (LLM-Chat).
anonymization Dezimal Punkteverbrauch für die Anonymisierung.
asr Dezimal Punkteverbrauch für die Spracherkennung (ASR).
tts Dezimal Punkteverbrauch für Text-to-Speech (TTS).
rerank Dezimal Punkteverbrauch für die Vektor-Neusortierung.
database_processing Dezimal Punkteverbrauch für die Datenbankverarbeitung.
tool_call Dezimal Punkteverbrauch für Werkzeugaufrufe.
knowledge_doc_indexing Dezimal Punkteverbrauch für die Wissensdatenbank-Indizierung.
question_tag Dezimal Punkteverbrauch für die Kennzeichnung von Fragen.
total Dezimal Gesamter Punkteverbrauch dieser Ausführung.
total long Gesamtanzahl der entsprechenden Ausführungen (für die Paginierung).
page int Aktuelle Seitenzahl.
page_size int Anzahl der Elemente pro Seite.
start_time long Abfrage-Startzeit.
end_time long Abfrage-Endzeit.

Fehlgeschlagene Antwort

Feld Typ Beschreibung
code int Fehlercode.
message string Fehlermeldung.

Fehlercodes

Code Nachricht
40000 Parameterfehler
40001 Ungültiger Zeitbereich (mehr als 30 Tage)
50000 Interner Systemfehler