api.transglot.ai/v1धारकटोकनम्, एकः प्रकल्पःसन्दर्भः

सञ्चिकां प्रेषयन्तु। सर्वाः भाषाः पुनः प्राप्नुवन्तु।

भवतः अनुप्रयोगस्य अनुवादार्थं REST API। एकः POST मूलसञ्चिकां आरोहति, एकः GET सम्पूर्णं स्थानीयं आनयति, तथा धारकटोकनमेव सम्पूर्णं प्रमाणीकरणम्। यत् किञ्चित् HTTP भाषते तत् इदं चालयितुं शक्नोति।

अन्तः: एकः आह्वानः

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

बहिः

300,000

Starter इत्यत्र मासिकशब्दाः, प्रथमा योजना या टोकनं जनयितुं शक्नोति।

निःशुल्कं आरभ्यताम्विकासकदृश्यं पश्यन्तु

टोकनप्रति प्रतिनिमिषं ६० आह्वानाः · प्रत्येकं ४२९ Retry-After सह आगच्छति · CI तथा उत्पादनार्थं पृथक् टोकनानि दद्युः

कन्सोलः API ग्राहकः अस्ति

प्रेषयन्तु, अनुवदन्तु, नियन्त्रयन्तु तथा आहरन्तु, प्रत्येकं REST अन्तबिन्दुः अस्ति।

अधस्तात् चित्रे विद्यमाना प्रत्येका पङ्क्तिः पश्चादेकं मार्गं धारयति: प्रेषणम्, द्वारपालकाः, शब्दकोशः, समूहाः तथा आहरणम्, सर्वे स्वकीयेन कोडेन प्रकल्पटोकनेन सह प्राप्याः। कन्सोले API खेलस्थलं केवलपाठनयोग्यानि जीवन्तं भवतः प्रकल्पं प्रति चालयति, अतः भवान् प्रथमं वास्तविकं प्रतिसादं द्रष्टुं शक्नोति।

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

भवान् मूलसञ्चिकां आरोहति
POST/v1/push
द्वारपालकफलकं पूर्यते
POST/v1/qa/run
भवान् पदं बद्धं करोति
POST/v1/glossary
समूहदृश्यं स्वयं परिशीलयति
GET/v1/batches/:id
भवान् अनुवादान् पुनः गृह्णाति
GET/v1/pull

प्रत्येक पटलिकायाः एकं मार्गम्, प्रतिनिमेषं षष्टिः, टोकन्‌प्रति क्षमताः · अनुवादान् प्रसारयितुं अपि एका अन्त्यबिन्दुः

एतत् केवलं HTTP अस्ति

चत्वारि वस्तूनि यानि दलाः प्रथमं निर्मायन्ते।

प्रत्येकं एकैव अन्त्यबिन्दुः च प्रकल्प-टोकन्‌ च · तेषां कस्यापि कार्याय अपराह्नस्य आवश्यकता न भवति

merge gate · एकं वर्कफ़्लो सञ्चिका

अनुवादस्य असफलतायाः सति पुल्ल अनुरोधं रक्तवर्णे परिवर्तयन्तु।

क्रॉन्‌ · रात्रिकालीनम्

प्रतिरात्रं विमोचन टिप्पणीनां अनुवादं कुर्वन्तु।

बोट्‌ · एकं सदस्यत्वम्

समूहस्य समाप्तिक्षणे स्लैक्‌ इत्यत्र प्रकाशयन्तु।

एजेण्ट्‌ · MCP

एकस्मै कृत्रिमबुद्धि-प्रतिनिधये तव समानानि १७ उपकरणानि ददातु।

प्रतिनिमेषं अनुरोधानि

प्रति खातं न किन्तु प्रति टोकन्‌, प्रत्येकं ४२९ त्रुटौ Retry-After शीर्षकेण सह प्रतीक्षायाः सेकेण्ड्‌ संख्यां दर्शयन्।

सञ्चिका प्रकाराः

भवतः भण्डारे वर्तमानं स्वरूपं पुष्यन्तु वा आहरन्तु वा। बहुत्वं च स्थानधारकाः उभयोः दिशासु सुरक्षिताः तिष्ठन्ति। उभयत्र आह्वाने format= इत्यनेन नाम दद्यात्।

वेबहुक्‌ घटनाः

सम्पूर्णः सूची, यस्यां प्रत्येकस्य वास्तविकं वितरणं यथा वहति तथैव उदाहरण भारः अस्ति। GET /v1/webhooks/events इति पश्यन्तु।

MCP साधनानि

सा एव प्रकल्प टोकन्‌, curl इत्यस्य स्थाने एजेण्ट्‌ रनटाइम्‌ इत्यस्मिन् दीयते। npx -y @transglot/mcp इति चलयन्तु।

सामान्यप्रश्नाः

प्रथम अनुरोधपूर्वम् विकासकाः यत् पृच्छन्ति।

Transglot API इत्यनेन सह कथं प्रमाणीकरणं करणीयम्?

Bearer टोकन्‌ प्रेषयन्तु: Authorization: Bearer $TRANSGLOT_TOKEN. टोकन्‌ एकस्मै प्रकल्पाय सम्बद्धा अस्ति, अतः पथे प्रकल्प ID नास्ति च खाता व्यापकं कुञ्चिकां लीकं न भवति। यूयं प्रकल्प पृष्ठे टोकन्‌ निर्मातुं शक्नुवन्ति च प्रत्येकं स्वकीयाः क्षमताः वहति: पुष्, पुल्ल्, प्रबन्ध, पठन, लेखन।

API निःशुल्कम् अस्ति?

न। Bearer टोकन्‌ Starter योजनायां मासिकं $१९ मूल्येन आरभते। निःशुल्कं केवलं कन्सोलं आवृतं करोति, यत् उत्पादं उपयुक्तं अस्ति वा न इति ज्ञातुं पर्याप्तम्, किन्तु तत् टोकन्‌ निर्मातुं न शक्नोति। CLI, GitHub Action, वेबहुक्स्, MCP च वितरण बण्डल्‌ एतस्याः एव टोकन्‌ पृष्ठे तिष्ठन्ति, अतः ते सर्वे एकत्र आगच्छन्ति।

Transglot इत्यत्र स्ट्रिङ्ग्स्‌ कथं आरोपयितव्याः?

सञ्चिकायाः च तत्स्वरूपस्य च सह POST /v1/push इति कुर्वन्तु, उदाहरणार्थं -F "file=@lang/en.json" -F "format=laravel_json". एतत् २०२ उत्तरं ददाति च समूहं कतारयति। केवलं ये पङ्क्तयः वास्तवतः परिवर्तिताः ते अनुदिताः भवन्ति, अतः अपरिवर्तितसञ्चिकायाः पुषिङ्गेन किमपि व्ययः न भवति।

अनुवादान् पुनः कथं प्राप्नुयाम्?

२० स्वरूपेषु यस्मिन् कस्मिन् अपि समयं GET /v1/pull इति कुर्वन्तु। एतत् अन्त्यबिन्दुः अस्ति यत् CLI आवृतं करोति, च यत् API प्लेग्राउण्ड्‌ जीवन्तं चालयति। निर्यात अनुरोधस्य कश्चन सञ्चिका नास्ति च कश्चन कालावधि नास्ति यत्र दत्तांशः भवतः स्वामित्वं त्यजति।

What is the API rate limit?

60 requests a minute, counted per token rather than per account. Over it you get a 429 with a Retry-After header saying how many seconds to wait, and nothing is charged or half written. Give CI and production separate tokens and a noisy build cannot starve your app.

एपीआई किं भाषाः समर्थयति?

कोऽपि स्थिरः सूची नास्ति। मान्यकर्ता यान् BCP-47 टैगान् ICU अभिजानाति तान् स्वीकारयति, येषु सङ्ग्रहे ७०८ स्थानीयभाषाः (locales) अन्तर्भवन्ति, तथा च तद्बहिर्गतटैगानामार्थं संरचनात्मकः पश्चगामी विकल्पः उपलभ्यते। परियोजनायां स्थानीयभाषां योजयन्तु, अनन्तरं प्रेषणे सा समाविष्टा भविष्यति।

किं सञ्चिकाप्रारूपाणि प्रेषयितुं तथा प्राप्तुं शक्यन्ते?

विंशतिः: JSON सरलं तथा नेस्टेड्, Laravel PHP तथा JSON, Android XML, iOS .strings, .stringsdict तथा .xcstrings, Flutter ARB, XLIFF 1.2 तथा 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV तथा Unreal PO। एतेषु सप्त प्रारूपाणि बहुत्वम् (plurals) वहन्ति, तथा च सञ्चिका तदैव आकारेण प्रत्यागच्छति यथा सा प्रेषिता आसीत्।

किं Transglot वेबहुक्स (webhooks) समर्थयति?

आम्। द्वादश वेबहुक् घटनाः सन्ति, येषु batch.completed, translation.reviewed, qa.completed तथा source_drift.repaired सम्मिलिताः। प्रत्येकं वितरणं HMAC हस्ताक्षरेण युक्तं समयमुद्राशीर्षकेण सह भवति येन तस्य सत्यापनं कर्तुं शक्यते, तथा च GET /v1/webhooks/events आदेशः प्रत्येकस्य नमूनाभारं (sample payload) सहितं सूचीं प्रदाति।

किं कृत्रिमबुद्धिमत्ता-अभिकर्तृणां (AI agents) कृते MCP सर्वरः अस्ति?

आम्। npx -y @transglot/mcp तव प्रकल्प-टोकनेन १७ उपकरणानि प्रकटीकरोति, अतः सहायकः अनुवादं पठितुं, लेखितुं, भाषां योजयितुं, कार्यं आरभ्यितुं, बैच् परीक्षितुं वा शब्दकोशं सम्पादयितुं शक्नोति। एतत् समानमेव API तथा समानान्यधिकाराणि, किन्तु curl-स्थाने प्रतिनिधि-रन्टाइम्-तः प्राप्यन्ते।

किं तत् CI मध्ये चालयितुं शक्यते?

आम्। GitHub Action (transglot/transglot-action@v1) तथा CLI च एतान् एण्डपॉइण्ट्स् आवृत्य स्थितौ स्तः। यदा काचित् पङ्क्ति निराक्रियते, तदा transglot push --wait ४ इत्यनेन निर्गच्छति तथा Action तस्मिन् रने स्वकार्यं विफलं करोति। विलयं रोधयितुं, तत् पुल्लिस्टेषु चालयित्वा तस्य कमिट्-इनपुट् 'none' सेट् कुर्वन्तु, यद् योजितं सञ्चिकायां कुञ्जी नास्ति चेत् विफलं भविष्यतीति पदं योजयन्तु, तथा शाखा-सुरक्षायां तत् कार्यं आवश्यकं परीक्षणं कुर्वन्तु।

यदि अनुवादः गुणवत्तापरीक्षणे विफलः भवति तर्हि किं भवति?

चत्वारः नियताः गेट्स् प्रत्येकां पङ्क्तिं पठन्ति: placeholders, plurals, glossary terms तथा length। भग्नः placeholder, अनुपलब्धा plural form वा वर्जितः glossary term एकं स्वयं-संशोधन-प्रयासं लभते, यदि पुनः अपि असफलं भवति तदा पङ्क्ति लिखित्वा न निराक्रियते केवलं निराक्रियते। या पङ्क्ति केवलं तस्याः दीर्घतां अतिक्रामति सा लिख्यते, न तु निराक्रियते। GET /v1/batches/:id?include=failures निराकृताः पङ्क्तयः तथा तेषां कारणानि सूचयति।

किं एपीआई कदाचित् भवतः समाकलनं भङ्गयति?

न। /v1 केवलं अन्तबिन्दून् तथा उत्तरक्षेत्राणि एव वर्धयति; क्षेत्रं यत् भवान् पूर्वमेव व्याख्याति न तस्य आकारः परिवर्तते न च तत् अन्तर्धीयते। भङ्गकारी परिवर्तनं नवेन संस्करणपूर्णेन सह प्रेष्येत, यत् आरक्षितं तथा अधुना शून्यम् अस्ति। एपीआई परिवर्तनलेखा (changelog) प्रत्येकं विमोचनं अभिलिखति।