Obtenir la liste de consommation de crédits de conversation de l'Agent

Obtenir la liste de consommation de crédits de conversation de l'Agent

Vous pouvez utiliser cette interface pour obtenir les détails de consommation de crédits de conversation d'un Agent spécifique dans une plage de temps donnée, regroupés par conversationId, avec un retour maximal des données des 30 derniers jours.

Méthode de requête

GET

URL de l'appel

https://api.gptbots.ai/v1/account/agent/conversation/credits

Authentification de l'appel

Pour plus de détails, consultez la section sur les méthodes d'authentification dans Aperçu de l'API.

Fréquence des appels

Cette interface est comptabilisée dans le quota par minute des « API statistiques » de l'organisation, et partage ce quota avec d'autres interfaces statistiques (y compris les interfaces statistiques au niveau de l'organisation). En cas de dépassement, 40008 sera renvoyé.

Requête

Exemple de requête

curl -X GET 'https://api.gptbots.ai/v1/account/agent/conversation/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/agent/conversation/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \
  -H 'Authorization: Bearer your_apikey'

                    
Ce bloc de code dans la fenêtre flottante

En-tête de requête

Champ Type Description
Authorization Bearer ${token} Utilisez Authorization: Bearer ${token} pour l'authentification des appels, veuillez obtenir la clé sur la page des clés API comme token.

Paramètres de requête

Champ Type Obligatoire Description
start_time long Oui Heure de début de la requête, timestamp en millisecondes.
end_time long Oui Heure de fin de la requête, timestamp en millisecondes. L'intervalle entre start_time et end_time ne doit pas dépasser 30 jours.
page int Non Numéro de page, par défaut 1.
page_size int Non Nombre d'éléments par page, par défaut 20, maximum 100.
conversation_id string Non ID de la conversation.

Réponse

Exemple de réponse

{ "list": [ { "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6", "conversation_create_time": 1774838000000, "chat": 1.50, "anonymization": 0, "asr": 0, "tts": 0, "rerank": 0.30, "database_processing": 0, "tool_call": 0.20, "knowledge_doc_indexing": 0, "question_tag": 0, "moderation": 0.01, "total": 2.0 } ], "total": 1, "page": 1, "page_size": 20, "start_time": 1774837924000, "end_time": 1775183447000 }
                      
                      {
    "list": [
        {
            "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6",
            "conversation_create_time": 1774838000000,
            "chat": 1.50,
            "anonymization": 0,
            "asr": 0,
            "tts": 0,
            "rerank": 0.30,
            "database_processing": 0,
            "tool_call": 0.20,
            "knowledge_doc_indexing": 0,
            "question_tag": 0,
            "moderation": 0.01,
            "total": 2.0
        }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "start_time": 1774837924000,
    "end_time": 1775183447000
}

                    
Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ Type Description
list liste Liste détaillée de la consommation de crédits.
conversation_id string ID de la conversation.
conversation_create_time long Heure de création de la conversation (horodatage en millisecondes), null si l'enregistrement de la conversation a été supprimé.
chat décimal Consommation de crédits pour la conversation (LLM chat).
anonymization décimal Consommation de crédits pour l'anonymisation.
asr décimal Consommation de crédits pour la reconnaissance vocale (ASR).
tts décimal Consommation de crédits pour la synthèse vocale (TTS).
rerank décimal Consommation de crédits pour le réarrangement vectoriel.
database_processing décimal Consommation de crédits pour le traitement de base de données.
tool_call décimal Consommation de crédits pour l'appel d'outil.
knowledge_doc_indexing décimal Consommation de crédits pour l'indexation de la base de connaissances.
question_tag décimal Consommation de crédits pour l'étiquetage des questions.
moderation décimal Consommation de crédits pour la modération de contenu.
total décimal Consommation totale de crédits pour cette conversation.
total long Nombre total de conversations correspondant aux critères (utilisé pour la pagination).
page int Numéro de la page actuelle.
page_size int Nombre d'éléments par page.
start_time long Heure de début de la requête.
end_time long Heure de fin de la requête.

Réponse échouée

Champ Type Description
code int Code d'erreur.
message string Description de l'erreur.

Codes d'erreur

Code Message
40000 Erreur de paramètre
40001 Plage de temps non valide (plus de 30 jours)
50000 Erreur interne du système