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 |
