ترجمہ API
اسکرپٹ کے ذریعے اپنی دستاویزات Edgepedia ترجمہ کو بھیجیں اور ان کے تراجم حاصل کریں۔ یہ وہی سروس ہے جو ترجمہ صفحے پر دستیاب ہے، قیمتیں بھی وہی ہیں اور ادائیگی بھی انہی کریڈٹ سے ہوتی ہے۔
کلید حاصل کرنا
ترجمہ صفحے پر کلید بنائیں: سائن ان کریں، اوپر بائیں جانب اپنا اکاؤنٹ کھولیں، اور «API کلیدیں» کے تحت «بنائیں» منتخب کریں۔
ہر درخواست کے ساتھ کلید Authorization: Bearer ept_… کی صورت میں بھیجیں۔ اسے خفیہ رکھیں: جس کے پاس یہ کلید ہو، وہ آپ کے کریڈٹ خرچ کر سکتا ہے۔
قیمتیں
- معیاری: ہر 250 الفاظ پر 1 کریڈٹ (کم از کم 1)۔
- Pro: ہر 75 الفاظ پر 1 کریڈٹ (کم از کم 2)۔
- ایسی دو زبانوں کے درمیان ترجمے کی قیمت دگنی ہوتی ہے جن میں سے کوئی بھی انگریزی نہ ہو۔
- 100 کریڈٹ = USD 1۔
ترجمہ ناکام ہونے پر اس کے کریڈٹ واپس کر دیے جاتے ہیں۔
روٹس
بنیادی URL: https://translate.edgepedia.ai۔ درخواستیں اور جوابات JSON میں ہوتے ہیں؛ خرابی کی صورت {"error": "…"} ہے۔
GET /api/v1/languages
زبانوں کی فہرست، اور ہر زبان کے لیے یہ معلومات کہ Pro دستیاب ہے یا نہیں۔
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
آپ کے کریڈٹ۔
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
ترجمہ شروع کیے بغیر اس کی قیمت اور متوقع وقت۔ mode کی قدر standard یا pro ہوتی ہے۔
قیمت معلوم کرنے کی درخواست میں "source": "auto" بھی دیا جا سکتا ہے: جواب کے "source" میں وہ زبان درج ہوتی ہے جس کی شناخت ہوئی، ساتھ میں "detected": true بھی ہوتا ہے، اور پھر اسی کوڈ کے ساتھ ترجمہ شروع کیا جاتا ہے۔
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
متن یا زیادہ سے زیادہ 10 MB کی .txt، .md، .docx، یا .pdf فائل کا ترجمہ شروع کریں۔ اگر آپ چاہتے ہیں کہ قیمت آپ کی توقع سے مختلف ہونے پر درخواست مسترد (409) ہو جائے تو "expect_credits" شامل کریں۔ مکمل ترجمہ اسی جواب میں حاصل کرنے کے لیے "wait" شامل کریں (زیادہ سے زیادہ 120 سیکنڈ)۔
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
ترجمے کی حالت (queued، running، done، یا failed) اور، مکمل ہونے پر، اس کا متن۔ ناکامی کی صورت میں وجہ بتائی جاتی ہے۔ مکمل ترجمہ 30 دن تک حاصل کیا جا سکتا ہے۔
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
فائل کے ترجمے کا نتیجہ: .docx اور .pdf فائلوں کے لیے .docx، اور .txt اور .md کے لیے متن۔
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
آپ کے زیادہ سے زیادہ 50 تراجم، سب سے نیا پہلے۔
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
حالت کے کوڈ
| کوڈ | مطلب |
|---|---|
| 200 | OK؛ wait کے ساتھ شروع کی گئی درخواست کا ترجمہ مکمل ہو چکا ہے یا ناکام ہو گیا ہے۔ |
| 202 | شروع ہو گیا ہے، یا wait کے بعد بھی جاری ہے۔ |
| 400 | درخواست جس صورت میں بھیجی گئی ہے، اس کے مطابق ترجمہ ممکن نہیں؛ خرابی کے پیغام میں وجہ درج ہے۔ |
| 401 | کلید موجود نہیں، نامعلوم ہے، یا منسوخ ہو چکی ہے۔ |
| 402 | کریڈٹ ناکافی ہیں۔ |
| 404 | آپ کے اکاؤنٹ میں ایسا کوئی ترجمہ موجود نہیں۔ |
| 409 | قیمت آپ کی expect_credits کے مطابق نہیں؛ کوئی رقم وصول نہیں کی گئی۔ |
| 413 | فائل 10 MB سے بڑی ہے۔ |
| 429 | ایک منٹ میں 60 سے زیادہ درخواستیں آ چکی ہیں؛ Retry-After میں درج سیکنڈ گزرنے کے بعد دوبارہ کوشش کریں۔ |