Plans & Subscriptions

Choose the right subscription plan for your needs.

Overview

YODI offers subscription plans with fixed monthly quotas and rate limits. The current backend exposes these plans:

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

---

Subscription Plans

Available Plans

Plan	Price	API Calls/Month	Rate Limit	Notes
Freemium	Free	10	10 req/min	Test the API, community support
Premium 100	$10	100	50 req/min	Entry-level paid plan
Dev Pass	$19	1,000	100 req/min	All base features, email support, analytics
SMME Pass	$129	10,000	500 req/min	Advanced features, priority support
Pro Pass	$399	100,000	2,000 req/min	Complete access, dedicated support, SLA
Enterprise	Custom	Unlimited	Custom	Custom SLA and deployment

Detailed Plan Comparison

Endpoint: GET /subscription/plans

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

Response:

{
  "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
}

Freemium Plan

• 10 API calls / month
• Rate limit: 10 requests/minute
• Access to the core API
• Community support
• Standard documentation

Premium 100 ($10/month)

• 100 API calls / month
• Rate limit: 50 requests/minute
• Entry-level paid plan
• Suitable for small integrations

Dev Pass ($19/month)

• 1,000 API calls / month
• Rate limit: 100 requests/minute
• All base features
• Email support
• Usage analytics

SMME Pass ($129/month)

• 10,000 API calls / month
• Rate limit: 500 requests/minute
• Advanced features
• Priority support
• Higher volume usage

Pro Pass ($399/month)

• 100,000 API calls / month
• Rate limit: 2,000 requests/minute
• Complete access to all APIs
• Dedicated support team
• SLA guarantee

Enterprise (Custom Pricing)

• Unlimited API calls
• Custom rate limits
• Custom SLA
• Dedicated account management
• Deployment support

---

Create Subscription

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"
  }'

Response:

{
  "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
}

---

Manage Subscription

View Current Subscription

Endpoint: GET /subscription

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

Upgrade Plan

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"
  }'

Upgrading immediately activates the new plan with prorated billing.

Cancel Subscription

Endpoint: PATCH /subscription/{id}/cancel

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

warning

Cancelling your subscription will:

• Retain your data for 30 days
• Stop credit regeneration
• Use remaining credits at current rate

---

Credits System

What are Credits?

Credits are the currency for consuming YODI APIs:

• Each supported service consumes one of the four backend credit buckets
• Monthly subscriptions renew credits automatically
• Unused credits roll over according to the product rules

Check Credit Balance

Endpoint: GET /credits/me

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

Response:

{
  "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
}

View Credits History

Endpoint: GET /services

List all available credit-based services.

View Service Quota

Endpoint: GET /services/{name}/quota

Check quota and usage for a specific service (for example translation, audio, voice_call, sms).

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

---

Credit Usage Examples

Service	Typical operation	Bucket
Translation	Translation requests	translation
Audio	Audio generation and speech workflows	audio
SMS	SMS delivery	sms
Voice Call	Voice call usage	voice_call

---

Billing & Payment

Payment is handled through Payments section.

---

FAQ

Q: What happens when I run out of credits? A: Your API requests will return a 402 error with { "message": "INSUFFICIENT_CREDITS", "error": true, "data": null, "status": 402 }. Top-up or upgrade your plan.

Q: Can I buy extra credits? A: Yes, through the dashboard or contact support for bulk purchases.

Q: Do unused credits expire? A: Credits roll over up to 3 months. After 3 months, they expire.

Q: Can I downgrade my plan? A: Yes, downgrades take effect at the next billing cycle.

---

Next Steps

• Payment & Transactions
• Start Using AI Services
• API Reference