अनुवाद 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" भी स्वीकार करता है: इसके उत्तर में "detected": true के साथ उस भाषा का नाम दिया जाता है जो "source" में पहचानी गई है, और फिर उसी कोड से अनुवाद शुरू किया जाता है।
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 में बताए गए सेकंड के बाद फिर से कोशिश करें। |