one-api

# One API تمام بڑے ماڈلز تک معیاری OpenAI API فارمیٹ کے ذریعے رسائی، اُتارنا اور استعمال کرنا تیار۔ ## حمایت یافتہ ماڈلز اور چینلز - OpenAI ChatGPT سیریز (Azure OpenAI سمیت) - Anthropic Claude سیریز (AWS Claude سمیت) - Google PaLM2 / Gemini سیریز - Mistral سیریز - Bytedance Doubao (Volcano Engine) - Baidu Wenxin Yiyang - Alibaba Tongyi Qianwen - iFlytek Spark - Zhipu ChatGLM - 360 Zhi Nao - Tencent Hunyuan - Moonshot AI، Baichuan، MINIMAX، DeepSeek - Groq، Ollama، Lingyi Wanwu، Jieyue Xingchen، Coze - Cohere، Cloudflare Workers AI، together.ai، novita.ai - SiliconCloud، xAI، DeepL وغیرہ ## بنیادی خصوصیات 1. **یکساں API مطابقت**: تمام چینلز OpenAIcompatible فارمیٹ میں انٹرفیس فراہم کرتے ہیں، کالنگ فریق کو کوڈ تبدیل کرنے کی ضرورت نہیں۔ 2. **لوڈ بیلنسنگ**: کثیر چینل روٹنگ کی حمایت کرتا ہے، گروپ ریٹ کے مطابق خودکار درخواست تقسیم کر سکتا ہے۔ 3. **ٹوکن مینجمنٹ**: ہر ایکسیس ٹوکن کے لیے expiry time، limits، مجاز IP رینج اور ماڈل لسٹ سیٹ کریں۔ 4. **چینل مینجمنٹ**: کثیر ذیلی چینلز کے بیچ بنانے اور منظم کرنے کی حمایت، ہر ایک کی ماڈل لسٹ الگ ترتیب دی جا سکتی ہے۔ 5. **صارف گروپنگ**: مختلف صارف گروپس کو مختلف ریٹ اور اجازتیں ترتیب دی جا سکتی ہیں۔ 6. **ایکسچینج کوڈز**: اکاؤنٹ ریچارج کے لیے ایکسچینج کوڈز کا بلک جنریشن اور ایکسپورٹ۔ 7. **ناکامی خودکار دوبارہ کوشش**: اپ اسٹریم چینل ناکام ہونے پر خودکار طور پر دوسرے دستیاب چینلز پر شفٹ کریں۔ 8. **ڈرائنگ انٹرفیس**: امیج جنریشن انٹرفیس ریچارج کی حمایت۔ 9. **دعوت انعام**: صارف دعوت مشن کی حمایت۔ 10. **کثیر مشین ڈپلائیمنٹ**: master/slave آرکیٹیکچر کے ساتھ ڈسٹریبیوٹڈ ڈپلائیمنٹ، Redis کے ساتھ کیچ سنکرونائزیشن۔ 11. **حسب ضرورت**: حسب ضرورت سسٹم نام، Logo، فوٹر، ہوم پیج اور about پیج کی حمایت۔ 12. **لاگ ان طریقے**: ای میل رجسٹریشن، Feishu authorization، GitHub authorization، WeChat official account authorization۔ 13. **Cloudflare AI Gateway**: براہ راست Cloudflare AI Gateway کے ساتھ جوڑ سکتا ہے۔ 14. **تھیم تبدیلی**: UI تھیم تبدیل کرنے کی حمایت۔ ## ڈپلائیمنٹ طریقے ### Docker ڈپلائیمنٹ (تجویز کردہ) ```shell # SQLite mode docker run --name one-api -d --restart always -p 3000:3000 \ -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data \ justsong/one-api # MySQL mode docker run --name one-api -d --restart always -p 3000:3000 \ -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \ -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data \ justsong/one-api ``` ابتدائی اکاؤنٹ: Username `root`، Password `123456`。 ### Docker Compose ڈپلائیمنٹ ```shell docker-compose up -d ``` Data `./data/mysql` directory میں محفوظ ہوتا ہے۔ ### Manual ڈپلائیمنٹ ```shell git clone https://github.com/songquanpeng/one-api.git cd one-api/web/default && npm install && npm run build cd ../.. && go mod download && go build -ldflags "-s -w" -o one-api ./one-api --port 3000 --log-dir ./logs ``` ### تھرڈ پارٹی پلیٹ فارمز Sealos، Zeabur، Render سمیت ایک کلک ڈپلائیمنٹ کی حمایت، Baota panel کے ساتھ بھی مطابقت پذیر۔ ## استعمال کا طریقہ 1. "چینل" صفحے پر مختلف ماڈلز کے API Key شامل کریں۔ 2. "ٹوکن" صفحے پر مخصوص صارفین کے لیے ایکسیس ٹوکن بنائیں۔ 3. CLI/فریم ورک میں API Base کو One API address (مثلاً `https://your-domain/v1`) اور API Key کو بنائے گئے ٹوکن پر سیٹ کریں۔ مخصوص چینل کو ٹوکن کے آخر میں `-CHANNEL_ID` لگا کر منتخب کیا جا سکتا ہے، مثلاً: `Authorization: Bearer ONE_API_KEY-1`。 ## اہم Environmental Variables | Variable | تفصیل | |---|---| | `REDIS_CONN_STRING` | Redis cache enable کریں | | `SESSION_SECRET` | Fixed session key، restart کے بعد login state برقرار رکھیں | | `SQL_DSN` | SQLite کی جگہ MySQL/PostgreSQL استعمال کریں | | `SYNC_FREQUENCY` | Cache sync frequency (seconds)، multi-machine deployment کے لیے تجویز کردہ | | `NODE_TYPE` | `master` یا `slave`، multi-machine deployment | | `FRONTEND_BASE_URL` | Server سے frontend requests ko redirect کریں | | `INITIAL_ROOT_TOKEN` | پہلی بار start پر خودکار طور پر root token بنائیں | ## Open Source License MIT license، page footer پر attribution اور project کے link کے ساتھ۔