Aller au contenu principal

Crédits et financement

Utilisez l'endpoint authentifié de financement pour connaître le modèle de solde actuellement appliqué à votre compte. Le backend sélectionne le modèle; ne le déduisez ni du nom d'un forfait ni du catalogue tarifaire.

Consultez Portefeuille commun et modèles de financement pour les deux réponses possibles et le fonctionnement des crédits disponibles et réservés.

Vérifier votre modèle de financement​

Endpoint : GET /credits/me/funding

Envoyez cette requête avec le cookie de session HTTP-only authentifié établi lors de la connexion YODI. N'incluez ni identifiant d'un autre utilisateur ni identifiant de portefeuille dans la requête.

L'endpoint authentifié retourne le modèle de solde sélectionné par le backend pour le compte connecté. Le propriétaire est dérivé par l'API; n'envoyez pas l'identifiant d'un autre utilisateur ni un identifiant de portefeuille.

Pour l'enveloppe de réponse et les variantes service_bucket et shared_wallet, consultez Portefeuille commun et modèles de financement.

Solde historique par service​

GET /credits/me reste disponible comme endpoint de compatibilité. Il retourne les anciens soldes par service et ne permet pas de déterminer si votre compte utilise le portefeuille commun. Préférez GET /credits/me/funding.

Endpoint : GET /credits/me

L'exemple shell utilise $YODI_SESSION_COOKIE comme espace réservé local pour le cookie de session authentifié. Ne consignez et ne versionnez jamais sa valeur.

curl -X GET "https://api.yodi.tg/v1/credits/me" \
  --cookie "$YODI_SESSION_COOKIE"

RĂ©ponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "id": 1,
    "quota": { "translation": 1000, "audio": 500, "sms": 200, "voice_call": 100 },
    "used": { "translation": 145, "audio": 23, "sms": 12, "voice_call": 5 },
    "source": "purchase",
    "expiresAt": "2025-01-01T00:00:00.000Z"
  },
  "status": 200
}

Catalogue historique des services​

Endpoint : GET /services

Retourne des informations sur les anciens soldes par service. Lorsque fundingModel vaut shared_wallet, ne considérez pas ces services comme des sous-portefeuilles dépensables.

Pour les prix actifs et les unités de facturation, consultez les tarifs unitaires des opérations.

Quota de service​

Endpoint : GET /services/{name}/quota

Cet endpoint ne retourne que les anciens quotas par service. Il ne fournit pas d'allocation du portefeuille commun et ne détermine pas si une opération est disponible.

curl -X GET "https://api.yodi.tg/v1/services/translation/quota" \
  --cookie "$YODI_SESSION_COOKIE"

Anciens blocs de crédits​

BlocClé backendCe que cela couvre
TraductiontranslationRequĂŞtes de traduction
AudioaudioGénération audio et flux vocaux
SMSsmsEnvoi de SMS
Appel vocalvoice_callUtilisation des appels vocaux

Notes​

  • Le chat, l'analyse et les autres opĂ©rations IA sont tarifĂ©s par opĂ©ration; consultez le catalogue actif au lieu de dĂ©duire un bloc de service.
  • Les quotas de requĂŞtes et les limites de dĂ©bit sont distincts des crĂ©dits.

Alertes de crédits faibles​

Configurez des alertes dans votre tableau de bord pour être averti lorsque vos crédits sont faibles.

Prochaines étapes​