Building a Persian Chatbot with Python and a Free OpenAI-Compatible API
Step-by-step tutorial for building a Persian CLI chatbot in Python using the OpenAI SDK, a custom Base URL, conversation history management, timeout, and error handling.
Open, machine-readable, evidence-based
Free LLM APIs
for Iran, verified.
Free quotas, models, OpenAI-compatible endpoints, and direct-connection evidence from Iran — each entry sourced from official documentation and dated.
Data-drivenNo sponsored ranking
TimestampedStale-data warnings
TransparentDirect, VPN, Signup separated
English Tutorials
Practical Guides for Using Free LLM APIs from Iran
Step-by-step tutorials covering provider selection, secure signup, error troubleshooting, rate-limit management, and code examples in Python and Node.js. These guides focus on the realities of connecting from inside Iran.
Fixing 401, 403, 404, and Model Not Found Errors in LLM APIs
Troubleshooting guide for invalid API key, regional permission, disabled model, wrong Base URL, and incompatible endpoint errors in language model APIs.
Fixing 429 Errors and Managing Rate Limits in Free LLM APIs
Expert guide to diagnosing quota types, implementing retry with backoff and jitter, request queuing, circuit breakers, and provider fallback for free language model APIs.
Choosing a Free LLM API in Iran: From Signup to First Request
Practical guide for selecting, signing up, testing connectivity, and making your first free LLM API request from inside Iran. Covers security, quota types, and access evidence.
Using a Free LLM API in Node.js with a Custom Base URL
Practical tutorial for connecting Node.js to OpenAI-compatible free LLM APIs, managing environment variables, streaming, timeout, retry, errors, and building a secure chat endpoint.
Interactive Catalog
Browse the Full Provider Catalog
The interactive catalog lives on the Persian-language homepage. Detailed provider profiles include Iran-access evidence, quotas, model lists, and OpenAI-compatible endpoints — all sourced from official documentation with dated verification.
Provider notes and Iran-access reports are currently Persian-first. The catalog JSON file is machine-readable and locale-neutral.
Data outdated or incorrect?
This catalog improves with accurate contributions.
Reports must include the official source, date, and connection path — no full IPs or API keys.