Terjime infrastrukturası üçin agent döwri.
Köpügüçe API-laryň köpüsi "terjime" diýlip, adam tarapyndan tekstiň web görnüşine ýapyşylmagy diýilende, döredildi. FluentC şu günki terjime üçin döredildi: bir agentiň sagatda müňlerçe gezek API-ny çagyryp, iş akymynyň arasynda, ulanyjy duýmadan öň jogap almagy umyt edip.
Bu üýtgeşme API aşagynda ähli zady üýtgetýär — howa saklamanyň işleýşi, toparlaryň işleýşi, bahalaryň gurluşy, nyrh çäklendirmeleriň hereketi. Biz onuň töweregindäki ykjamy täzeden gurdyk.
Bir önümi. Birnäçe hereket edýän bölekler. Ine, sapar.
Her bir bölüme, eger doly hekaýaty islese, has giňişleýin sahypa baglanyşykly.
Bir uç, üç giriş formaty, auth üçin bir UUID.
POST /ai_agent/translate metn, HTML we JSON-i işleýär. Siz giriş formatyny, maksat dilini we jogapyňy yzyna senkron ýa-da topar iş hökmünde almak isleýändigiňizi saýlaň. Bu ähli ýüz meýdany.
Hüsmä ber UUID awtoryzasiýa başlygynda. Token çalyşmasyz, başlamak üçin müşteri kitaphanalary talap edilmeýär. Curl işledi. n8n işledi. Bir LangChain guraly işledi. Näme saklaýan bolsaň, işläp durýar.
curl -X POST https://api.fluentc.io/ai_agent/translate \ -H "Authorization: 4f3a-uuid-...-9c2e" \ -H "Content-Type: application/json" \ -d '{ "input_format": "json", "target_language": "es", "mode": "sync", "content": { "title": "Hello", "body": "Welcome" } }' # 204ms · 200 OK { "translation": { "title": "Hola", "body": "Bienvenido" }, "target_language": "es", "tm_hit": false, "request_id": "tx_8f3a72c4" }
Agentiň aramyzda gürleşýän wagtynda we häzir jogap gerek bolsa.
Synkron sorag, jogapda terjime edilen tekst, sorag ýok.
Görnüşleriň yzasynda, açar hökmünde içerik-ýol açarly cache bar SHA256(target_language + input)Ikinji gezek şol bir setir geçip gider, siz modeli bütinleýin geçip gidýärsiňiz — şol bir terjime, şol bir açar, has çalt jogap.
Bu, seslenişi ýaly bolmaly bolandan has möhüm. Çok dilli chatbot jogap berýär salam on iki dilde şol cache'yi yzygiderli tapar.
50,000 sütün bardygy bar we olary bir gezekde gerek bolanda.
Işini tabşyr, netije al job_id Yza, netijeleri üçin sorag geçireniňde garaş. Google Sheet, önümi katalogy, JSON i18n faýllarynyň katalogy — islendik zat üçin işleýär.
JSON dogry işleýär: içki gurluşlar gezilýär, her bir setir bahasy garaşylýar we paralel ýagdaýda terjime edilýär, we asyl şekil soňunda gaýtadan birleşdirilýär. Açarlar açarlar. Sarp gurluşdyr.
Şol bir job_id daima ses berip bolýan ýerliklidir — bu bir siziň giriziňiziň deterministik hashi, rastgele bilet däl. Şol içerigi täzeden iberip, şol bir iş_id-ni we şol bir ýatda saklanan netijäni gaýtadan alarsyň.
Bir gezek töle "Satuwa goş" üçin. Daima.
Terjime ýadygärligi siz öňden töleýän terjimeleriň maglumatlar bazasydyr. Indiki gezek şol bir setir geçip gelende, siz gaýtadan tölemezsiňiz — we jogap has çalt bolar, sebäbi modele ýetmeýär.
Soňky terjime API-lary her gezek her bir harp üçin töleg alýar. Biz ýok. E-commerce kataloglary, makroklary goldaw berýär we gaýtalanýan setirleri bolan haýsydyr bir önümiň iň köp tygşytlary şu ýerde bolýar.
Siz hem-de bolup bilersiňiz sahypa saýty boýunça belli bir terjimeleri täzeden ýazmak modeliň standartyndan başga bir görkezme isleýän wagtyňyzda. Önümçüliklerinize hormat goýýar.
Siziň sorag edýän agentiňiziň islegine görä meýilnama.
Uruwpa dilleriniň esasy, Aziýa dilleriniň esasy, Arap, Ibrani, Hindi dilleri we şonuň yzarlar.
Sanaw cachelenip, görkezilýär at GET /ai_agent/languages, agentiňizde işjeňleşdirdigiňiz bilen çäklenendir.
Düýbiňize diller goşuň ýa-da aýyryň. Her agentiň öz işjeň seti bar — şonuň üçin on dilde terjime edýän Shopify agenti we üç dilde terjime edýän içeri goldawy agenti bir hesabda bolup biler.
Eger bahalajak bolsaňyz, bilmegiňiz gerek bolan bäş zat.
Birme-bir giriş + maksat dili cache hit. "Fuzzy match" geňeşmeleri ýok, gaýtalanýan setirler üçin çagyrma başyna töleg ýok.
Aýtsaň, şol bir partýa girişini täzeden ibermek şol bir iş_id-ni yzyna berýär. Dizayn boýunça idempotent.
Arka plan terjime işleri model wagtynyň wagt çäklendirmeleri (5 synanşyk, eksponensiýaly yza gaçyş) we nyrh çäklendirmeleri (10 synanşyk, Retry-After-i hormatlamak) boýunça gaýtalýar. Siz bu işi özüňiz üçin gurmaly dälsiňiz.
200 sütünlyk bahasy bolan dokument 200 yzygiderli model çagyryşyny ýerine ýetirmeýär — ol ýaýraýar we täzeden birleşýär.
Bütün API curl-den elýeterlidir. SDKlar bar, haýsyny isleseňiz; olar öňdebaryjy şert däl.
AçykAPI spesifikasiýasy şu ýerde çap edilýär /ai_agent/swagger.yml we weçişdirilen dokumentler at /ai_agent/docs.