Credit Packages
📞 Support & Feedback
Need help or found an issue with this documentation? Contact our support team on Telegram: t.me/AvalAISupport
We're here to assist with technical questions, billing inquiries, and documentation improvements.
AvalAI Credit Packages are prepaid API credit bundles for OpenAI, Gemini, Alibaba, and leading coding models. This live package catalog compares purchase prices, received credit values, discounts, validity periods, purchase limits, availability, and exact covered model IDs so you can choose a package that matches your AI workload and budget.
📋 Choosing the Right Option
💡 For New Users
If you're just getting started with AvalAI, you don't need to purchase credit packages. The best way to begin is by topping up your default credit balance and using the services directly. This approach provides complete flexibility in model selection and no time restrictions.
🏢 For Professional and Enterprise Users
Credit packages are designed for professional and enterprise users who:
- Have predictable and consistent usage patterns
- Frequently use specific models
- Want to benefit from significant discounts
- Can utilize credits within limited time periods
Note: Credit packages come with time limitations (currently 1-31 days) and specific service scope restrictions.
⚠️ Critical Balance Requirement
To utilize credit packages effectively, your general account balance (default credit) must remain positive. API services will be automatically deactivated if the general balance reaches zero or becomes negative.
Strong Recommendation: Maintain a minimum balance of 1.0 UNIT in your general account balance to ensure uninterrupted service and proper functioning of credit packages.
⚠️ Flex Service Tier Exclusion
Credit packages do NOT cover Flex Service Tier costs. When using
service_tier: "flex"in your API requests, costs are charged to your standard account balance, not deducted from credit package allocations. Credit packages only apply to standard service tier usage.
What are Credit Packages?
Credit Packages are specialized billing products that give you more credits than what you pay for, with restrictions on which models you can use. For example, you might pay 350,000 IRT but receive 500,000 IRT worth of credits (25% bonus) that can only be used with specific AI models for a limited time period.
Key Benefits
- Cost Savings: Current available packages discount their listed credit value by 20%-40%
- Model Access: Access to premium models at discounted rates
- Flexible Options: Various packages for different use cases and budgets
- Transparent Pricing: Clear value ratios and model restrictions
How Credit Packages Work
Package Structure
Each credit package includes:
- Payment Amount: What you actually pay (e.g., 350,000 IRT)
- Credit Value: Total credits you receive (e.g., 500,000 IRT)
- Value Ratio: Bonus percentage (e.g., 25% more credits)
- Package Scope: Specific models or services covered
- Validity Period: How long the package remains active
- Usage Limits: Maximum purchases per user
Package Scopes
Credit packages are restricted to specific scopes and models:
- API Service: All packages currently focus on API usage (not subscription services)
Validity and Expiration
- Current packages have fixed validity periods of 1, 7, 30, or 31 days
- Credits expire automatically when the validity period ends
- Non-refundable: Expired or unused credits cannot be refunded
- Non-transferable: Credits cannot be moved between accounts
Available Package Types
Updated · View source API
Compare current AvalAI credit packages for OpenAI, Gemini, Alibaba, and coding models by purchase price, credit value, discount, validity period, purchase limit, and covered model IDs. Cards labeled Available are purchasable in the latest API data; packages absent from that data remain visible as Unavailable historical references. Confirm live availability in the AvalAI credit-package marketplace before purchasing.
Gemini Packages
Daily Gemini Packages
d-g3050sd-g6010md-g3550lWeekly Gemini Packages
w-g1420sw-g3550mw-g7010lMonthly Gemini Packages
m-g8010mm-g5070lCovered Models (Gemini)
gemini-3.6-flashgemini-3.5-flashgemini-3.5-flash-litegemini-3.1-flash-lite-imagegemini-3.1-flash-imagegemini-3.1-flash-previewgemini-3.1-pro-previewgemini-3.1-flash-litegemini-3.1-flash-image-previewgemini-3-flash-previewgemini-3-pro-image-previewgemini-2.5-progemini-2.5-flashgemini-2.5-flash-lite
Vibe Coder Packages
Daily Vibe Coder Packages
d-b3550sd-b1420md-b3550lWeekly Vibe Coder Packages
w-b8010sw-b1620mm-b5070lw-b4050lCovered Models (Vibe Coder)
qwen3.8-maxkimi-k3claude-opus-5claude-sonnet-5gpt-5.6-solglm-5.2kimi-k2.7-codeminimax-m3qwen3.8-2.4t-a95bqwen3.7-plusnemotron-3-ultrakimi-k2.6qwen3.6-plusminimax-m2.7deepseek-v4-prodeepseek-v4-flashnemotron-3.5-lightningmuse-glimmer-30b
OpenAI Packages
Daily OpenAI Packages
d-o3050sd-o6010md-o3550lWeekly OpenAI Packages
w-o1420sw-o7010lMonthly OpenAI Packages
m-o5070lCovered Models (OpenAI)
gpt-5.6-solgpt-5.6-terragpt-5.6-lunagpt-5.5gpt-image-2gpt-5.4gpt-5.4-minigpt-5.4-nanogpt-5.3-codexgpt-5.3-chatgpt-5.2-chattext-embedding-3-largetext-embedding-3-small
Claude (Anthropic) Packages
⚠️ Unavailable
These historical packages do not appear in the current API snapshot. They are retained only for reference.
Daily Claude Packages
historical-claude-daily-basichistorical-claude-daily-professionalhistorical-claude-daily-enterpriseWeekly Claude Packages
historical-claude-weekly-basichistorical-claude-weekly-professionalhistorical-claude-weekly-enterpriseMonthly Claude Packages
historical-claude-monthly-enterpriseHistorical Covered Models (Claude / Anthropic)
claude-opus-4-5claude-opus-4-1claude-sonnet-4-5claude-haiku-4-5anthropic.claude-opus-4-1-20250805-v1:0anthropic.claude-sonnet-4-5-20250929-v1:0anthropic.claude-haiku-4-5-20251001-v1:0anthropic.claude-opus-4-20250514-v1:0anthropic.claude-sonnet-4-20250514-v1:0anthropic.claude-3-7-sonnet-20250219-v1:0
Alibaba Packages
Daily Alibaba Packages
d-a3550sd-a7010md-a3550lWeekly Alibaba Packages
w-a1620sw-a4050mw-a8010lMonthly Alibaba Packages
m-a5062lCovered Models (Alibaba)
qwen3.8-maxqwen3.7-plusqwen3.6-flashqwen3.8-2.4t-a95bqwen3.6-35b-a3bqwen3.6-27bqwen3.6-plusqwen3.5-flashqwen3-coder-nextqwen3.5-27bqwen3.5-35b-a3bqwen3.5-122b-a10bqwen3.5-397b-a17bqwen3.5-plusqwen3-maxqwen3-next-80b-a3b-thinkingqwen3-next-80b-a3b-instructqwen3-coder-flashqwen3-coder-plusqwen3-coder-480b-a35b-instructqwen3-235b-a22b-instruct-2507qwen3-235b-a22bqwen3-32bqwen3-30b-a3bqwen3-30b-a3b-instruct-2507qwen3-30b-a3b-thinking-2507qwen3-14bqwen3-8bqwen3-4bqwen3-vl-32b-instructqwen3-vl-flashqwen3-vl-plusqwen-flashqwen-plusqwen-image-editqwen-image-plusqwen-image-edit-plusqwen-mt-flashqwen-mt-liteqwen-mt-plustext-embedding-v4text-embedding-v3
Web Search Packages
⚠️ Unavailable
These historical packages do not appear in the current API snapshot. They are retained only for reference.
Monthly Web Search Packages
m-ws5062lHistorical Covered Models (Web Search)
perplexity-search
Special Enterprise Packages
Special OpenAI Enterprise Package
m-o1013xlCovered Models (Special OpenAI Enterprise)
gpt-5.6-solgpt-5.6-terragpt-5.6-lunagpt-5.5gpt-image-2gpt-5.4gpt-5.4-minigpt-5.4-nanogpt-5.3-codexgpt-5.3-chatgpt-5.2-chattext-embedding-3-largetext-embedding-3-small
⚠️ Unavailable
These historical packages do not appear in the current API snapshot. They are retained only for reference.
Historical Special Enterprise Package
m-s1011xlHistorical Covered Models (Special Enterprise)
gemini-2.5-flash-imagegemini-2.5-progemini-2.5-flashgemini-2.5-flash-litegemini-2.5-flash-image-previewgemini-2.0-flashgemini-2.0-flash-litegpt-5-chatgpt-5-minigpt-5-nanoo4-minio3-minigpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-minigpt-4o-transcribegpt-4o-mini-transcribegpt-4o-mini-ttsperplexity-searchgoogle_pse-search
Package Scope Details
Important: Each package is exclusively designed for use within its authorized scope. Using services outside the package coverage will be charged at standard rates without discounts.
Purchasing Credit Packages
Prerequisites
- Authentication Required: You must be logged in to purchase packages
- Payment Methods: Bank Card or existing Credit Balance
- Verification: OTP verification required for purchases
Purchase Process
- Browse Packages: Visit AvalAI Billing Packages
- Select Package: Choose your desired package and quantity
- Payment Method: Select Bank Card or Credit Balance
- OTP Verification: Enter the 6-digit code sent to your phone
- Confirmation: Package is added to your account immediately
Managing Your Credit Packages
Package Dashboard
Access your packages through the AvalAI Platform to:
- View active and expired packages
- Monitor usage statistics
- Check expiration timelines
- Track remaining credits
Package Status Types
- Active: Package is valid and has remaining credits
- Expired: Package validity period has ended
- Exhausted: All package credits have been used
- Promotional: Special discount packages
Usage Tracking
Monitor your package usage through:
- Real-time Balance: Current remaining credits
- Usage Analytics: Detailed consumption patterns
- Model Breakdown: Credits used per model
- Expiration Alerts: Notifications before packages expire
Important Terms and Conditions
Account Balance Requirements
- Positive Balance Required: Your general account balance must always remain positive for credit packages to function properly.
- Automatic Service Deactivation: If the general balance reaches zero or becomes negative, all API services will be immediately deactivated.
- Recommended Minimum Balance: Maintain at least 1.0 UNIT in your general balance to ensure uninterrupted operation.
- Usage Priority: Package credits are consumed before general balance, but the general balance must still remain positive.
Non-Refundable Policy
- No Refunds: Credit packages cannot be refunded once purchased
- No Extensions: Expired packages cannot have their validity extended
- No Transfers: Credits cannot be transferred between accounts or packages
Expiration Rules
- Fixed Validity: Each package has a predetermined validity period
- Automatic Expiration: Credits are automatically removed when packages expire
- No Grace Period: No additional time is provided after expiration
- Immediate Effect: Expiration occurs at the exact end of the validity period
Usage and Purchase Limitations
- Scope Restrictions: Credits can only be used with authorized models.
- Standard Rate Fallback: Non-covered models are charged at regular rates.
- One Active Package of Each Type: For packages whose card says Limit 1 per user, you cannot have more than one active package with the same template ID. For example, while one
d-g3050spackage is active, you cannot purchase anotherd-g3050spackage. - No Reserved Packages: Credit packages cannot be purchased in advance and held as pending or reserved for activation after the active package expires. A new package of the same type can be purchased only after the current one is no longer active.
- Different Package Types Are Allowed: You may hold multiple active credit packages at the same time when they are different types (different template IDs), subject to each card's purchase limit.
- Special Limits: A card showing Limit 2 per user permits up to two active packages of that exact type; all other displayed limits apply as written on the card.
- Account Binding: Packages are tied to the purchasing account.
Model Coverage
Package scope determines which models receive discounted rates:
- In-Scope Usage: Discounted rates apply automatically
- Out-of-Scope Usage: Standard pricing applies
- Mixed Usage: Credits are consumed based on model coverage
- Priority Order: Package credits are used before general balance
Best Practices
Choosing the Right Package
- Analyze Usage Patterns: Review your typical model usage
- Calculate Value: Compare package savings vs. standard rates
- Consider Validity: Ensure you can use credits within the time limit
- Model Requirements: Verify the package covers your needed models
Maximizing Value
- Plan Usage: Use package credits for high-value models first
- Monitor Expiration: Track validity periods closely
- Batch Processing: Complete intensive tasks during package validity
- Model Selection: Prioritize in-scope models for maximum savings
Troubleshooting
Common Issues
Package Not Appearing
- Verify payment completion and OTP confirmation
- Check account authentication status
- Contact support if payment was processed but package is missing
Credits Not Applied
- Ensure you're using models within the package scope
- Verify package is still within validity period
- Check if package credits are exhausted
Payment Problems
- Verify sufficient credit balance for Credit Balance payments
- Ensure bank card has adequate funds for card payments
- Complete OTP verification process
Sudden Service Interruption
- If your API services have been deactivated, first check your general account balance
- Ensure your general balance is positive (minimum 1.0 UNIT recommended)
- Services will automatically reactivate after topping up your general balance
Verifying Credit Package Usage
If you need to verify whether a specific API request used your credit package credits, you can use the Transaction Lookup API or the Dashboard reports.
Using Transaction Lookup API
Use the avalai-request-id header from any API response to look up detailed transaction information:
curl https://api.avalai.ir/user/v1/transactions/lookup \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AVALAI_API_KEY" \
-d '{
"transaction_ids": ["your-avalai-request-id-here"]
}'The response will show exactly how the transaction was charged:
{
"transactions": [
{
"id": "019b4a90-bfed-7cc1-97c1-7abcc10e7e75",
"model": "qwen3-max",
"cost": {
"unit": "0.00007800",
"paid_unit": "0.00007800",
"paid_irt": "0",
"paid_grant_irt": "10.35",
"source": "credit_package",
"currency": "UNIT"
},
"packages": [
{
"id": "7794",
"template_id": "d-a3550s",
"name": "Daily Alibaba Basic",
"remaining_irt": "499507.15",
"end_date": "2025-12-24T09:24:02.705Z"
}
]
}
]
}Key fields to check:
| Field | Description |
|---|---|
cost.source | Shows "credit_package" if package was used, "balance" if charged to general balance |
cost.paid_irt | Amount charged to general balance (0 if credit package covered the cost) |
cost.paid_grant_irt | Amount deducted from credit package |
packages | Details of the active credit package used |
packages[].remaining_irt | Remaining balance in the credit package |
packages[].end_date | When the credit package expires |
For more details on the Transaction Lookup API, see User API Reference.
Using Dashboard Reports
You can also generate comprehensive usage reports through the AvalAI Dashboard:
- Visit Usage Reports
- Select your desired date range
- Generate a CSV report containing all transaction details
- The report includes columns for cost source, package information, and billing details
This is useful for:
- Auditing credit package usage over time
- Reconciling monthly billing
- Exporting data for accounting purposes
- Analyzing usage patterns across different models
Related Resources
- Pricing Overview - Standard pricing and rate information
- User API Reference - Transaction lookup and account management
- Cost Tracking Guide - Detailed cost tracking for resellers and enterprise users
- API Authentication - Setting up API access
- Rate Limits - Understanding usage limits
- Usage Reports - Generate CSV reports in dashboard
- Billing Support - Contact support for billing issues
- Marketplace - Browse and purchase packages