Forfaits et Abonnements

Choisissez le forfait d'abonnement adapté à vos besoins.

Aperçu

YODI propose des forfaits d'abonnement avec des quotas mensuels et des limites de débit fixes. Le backend actuel expose les forfaits suivants :

• freemium
• premium_100
• dev_pass
• smm_pass
• pro_pass
• enterprise

---

Forfaits d'abonnement

Forfaits disponibles

Forfait	Prix	Appels API/mois	Limite de débit	Remarques
Freemium	Gratuit	10	10 req/min	Tester l'API, support communautaire
Premium 100	10 $	100	50 req/min	Forfait payant d'entrée de gamme
Dev Pass	19 $	1 000	100 req/min	Fonctionnalités de base, support e-mail, analytique
SMME Pass	129 $	10 000	500 req/min	Fonctionnalités avancées, support prioritaire
Pro Pass	399 $	100 000	2 000 req/min	Accès complet, support dédié, SLA
Enterprise	Sur mesure	Illimité	Sur mesure	SLA et déploiement personnalisés

Comparaison détaillée des forfaits

Endpoint : GET /subscription/plans

curl -X GET "https://admin.yodi.tg/api/subscription/plans" \
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "plans": [
      { "id": 1, "name": "freemium", "price": 0, "quota_limit": 10, "rate_limit": 10 },
      { "id": 2, "name": "premium_100", "price": 10, "quota_limit": 100, "rate_limit": 50 },
      { "id": 3, "name": "dev_pass", "price": 19, "quota_limit": 1000, "rate_limit": 100 },
      { "id": 4, "name": "smm_pass", "price": 129, "quota_limit": 10000, "rate_limit": 500 },
      { "id": 5, "name": "pro_pass", "price": 399, "quota_limit": 100000, "rate_limit": 2000 },
      { "id": 6, "name": "enterprise", "price": null, "quota_limit": null, "rate_limit": null }
    ]
  },
  "status": 200
}

Forfait Freemium

• 10 appels API / mois
• Limite de débit : 10 requêtes/minute
• Accès à l'API principale
• Support communautaire
• Documentation standard

Forfait Premium 100 (10 $/mois)

• 100 appels API / mois
• Limite de débit : 50 requêtes/minute
• Forfait payant d'entrée de gamme
• Adapté aux petites intégrations

Dev Pass (19 $/mois)

• 1 000 appels API / mois
• Limite de débit : 100 requêtes/minute
• Fonctionnalités de base
• Support par e-mail
• Analytique d'utilisation

SMME Pass (129 $/mois)

• 10 000 appels API / mois
• Limite de débit : 500 requêtes/minute
• Fonctionnalités avancées
• Support prioritaire
• Usage à plus grand volume

Pro Pass (399 $/mois)

• 100 000 appels API / mois
• Limite de débit : 2 000 requêtes/minute
• Accès complet à toutes les API
• Équipe de support dédiée
• Garantie SLA

Enterprise (Tarification personnalisée)

• Appels API illimités
• Limites de débit personnalisées
• SLA personnalisé
• Gestion de compte dédiée
• Aide au déploiement

---

Créer un abonnement

Endpoint : POST /subscription/create

curl -X POST "https://admin.yodi.tg/api/subscription/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "planId": "plan_pro",
    "billingCycle": "monthly"
  }'

Réponse :

{
  "message": "SUCCESS",
  "error": false,
  "data": {
    "id": "sub_abc123",
    "planId": "plan_pro",
    "status": "active",
    "monthlyCredits": 500000,
    "creditsUsed": 0,
    "nextBillingDate": "2026-07-24",
    "price": 99
  },
  "status": 200
}

---

Gérer l'abonnement

Voir l'abonnement en cours

Endpoint : GET /subscription

curl -X GET "https://admin.yodi.tg/api/subscription" \
  -H "Authorization: Bearer YOUR_API_KEY"

Mettre à niveau le forfait

Endpoint : PUT /subscription/upgrade-plan

curl -X PUT "https://admin.yodi.tg/api/subscription/upgrade-plan" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "newPlanId": "plan_enterprise"
  }'

La mise à niveau active immédiatement le nouveau forfait avec une facturation au prorata.

Annuler l'abonnement

Endpoint : PATCH /subscription/{id}/cancel

curl -X PATCH "https://admin.yodi.tg/api/subscription/sub_abc123/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"

attention

L'annulation de votre abonnement :

• Conserve vos données pendant 30 jours
• Arrête la régénération des crédits
• Utilise les crédits restants au tarif actuel

---

Système de crédits

Que sont les crédits ?

Les crédits sont la monnaie de consommation des API YODI :

• Chaque service pris en charge consomme un des quatre blocs de crédits du backend
• Les abonnements mensuels renouvellent les crédits automatiquement
• Les crédits inutilisés sont reportés selon les règles du produit

Vérifier le solde de crédits

Endpoint : GET /credits/me

curl -X GET "https://admin.yodi.tg/api/credits/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

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
}

Voir l'historique des crédits

Endpoint : GET /services

Liste tous les services basés sur les crédits disponibles.

Voir le quota d'un service

Endpoint : GET /services/{name}/quota

Vérifiez le quota et l'utilisation d'un service spécifique (par exemple translation, audio, voice_call, sms).

curl -X GET "https://admin.yodi.tg/api/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Exemples d'utilisation des crédits

Service	Opération type	Bloc
Traduction	Requêtes de traduction	translation
Audio	Génération audio et flux vocaux	audio
SMS	Envoi de SMS	sms
Appel vocal	Utilisation des appels vocaux	voice_call

---

Facturation et paiement

Le paiement est géré via la section Paiements.

---

FAQ

Q : Que se passe-t-il lorsque je n'ai plus de crédits ? R : Vos requêtes API renverront une erreur 402 avec { "message": "INSUFFICIENT_CREDITS", "error": true, "data": null, "status": 402 }. Rechargez ou mettez à niveau votre forfait.

Q : Puis-je acheter des crédits supplémentaires ? R : Oui, via le tableau de bord ou contactez le support pour des achats en gros.

Q : Les crédits inutilisés expirent-ils ? R : Les crédits sont reportés jusqu'à 3 mois. Après 3 mois, ils expirent.

Q : Puis-je passer à un forfait inférieur ? R : Oui, le passage à un forfait inférieur prend effet au prochain cycle de facturation.

---

Prochaines étapes

• Paiements et transactions
• Commencer à utiliser les services d'IA
• Référence API