បង្កើតបញ្ជីវាក្យសព្ទ
កំណែ API 2026-10-affable-towhee
ផ្សាយបញ្ជីពាក្យតាមកម្រិតដែលបានស្នើ។ ស្ទ្រីមផ្ញើ started ជាមួយព័ត៌មានលម្អិតនៃបញ្ជី ព្រឹត្តិការណ៍ item មួយសម្រាប់ពាក្យនីមួយៗ បន្ទាប់មក done។ រហូតដល់បញ្ជីរួចរាល់ វាផ្ញើតែមតិ keepalive ប៉ុណ្ណោះ។
វិសាលភាព vocab:generate
ប៉ារ៉ាម៉ែត្រ
Lingara-Versionheaderstringស្រេចចិត្ត- កំណែ API ដែលត្រូវប្រើឆ្លើយសំណើនេះ។ បើគ្មានវាទេ token ចូលប្រើទទួលបានកំណែដែលម៉ាស៊ីនភ្ញៀវរបស់វាត្រូវបានភ្ជាប់ ហើយសំណើដែលគ្មាន token ទទួលបានកំណែបច្ចុប្បន្ន។ កំណែដែលកំពុងអភិវឌ្ឍអាចចូលដល់បានតែដោយដាក់ឈ្មោះវានៅទីនេះប៉ុណ្ណោះ។ កំណែដែលមិនស្គាល់ឆ្លើយតប
400ជាមួយកូដapi_version_unknown។GET /v1/versionsបង្ហាញបញ្ជីកំណែ។
ខ្លឹមសារសំណើ application/json
levelintegerចាំបាច់source_langstringចាំបាច់target_langstringចាំបាច់countinteger | nullស្រេចចិត្ត
ការឆ្លើយតប
200 បញ្ជី ពាក្យមួយក្នុងមួយព្រឹត្តិការណ៍
ព្រឹត្តិការណ៍ស្ទ្រីម text/event-stream
ផ្ញើមតិ keepalive រៀងរាល់ 15 វិនាទី។
-
startedVocabStarted -
metaVocabMetaចាំបាច់levelintegerចាំបាច់source_langstringចាំបាច់target_langstringចាំបាច់frameworkstringចាំបាច់countintegerចាំបាច់ai_generatedbooleanចាំបាច់
-
itemVocabItem -
wordstringចាំបាច់pronunciationstring | nullស្រេចចិត្តreadingstring | nullស្រេចចិត្តtranslationstringចាំបាច់exampleVocabExample | nullស្រេចចិត្តsentencestringចាំបាច់translationstringចាំបាច់
image_urlstring | nullស្រេចចិត្ត
-
doneDone បញ្ចប់ស្ទ្រីម -
errorStreamError បញ្ចប់ស្ទ្រីម -
មកដល់ក្នុងចម្លើយ 200។ បន្ទាត់ស្ថានភាពត្រូវបានផ្ញើរួចហើយ ដូច្នេះការបរាជ័យបន្ទាប់ពីស្ទ្រីមបើក ត្រូវបានរាយការណ៍ជាព្រឹត្តិការណ៍នេះ។
codestringចាំបាច់messagestringចាំបាច់plan_idstring | nullស្រេចចិត្ត
កំហុស
402application/json- ការហៅរបស់ក្លាយអិនត៍ដែលគិតថ្លៃតាមការប្រើប្រាស់ត្រូវបានបដិសេធ មុនពេលវាចំណាយអ្វីទាំងអស់។
spend_cap_reached៖ ក្លាយអិនត៍ ឬគណនីរបស់វាបានដល់កម្រិតចំណាយប្រចាំខែរបស់វាហើយ សូមដំឡើងកម្រិតនៅលើទំព័រ ការតភ្ជាប់។metered_billing_inactive៖ ការគិតថ្លៃតាមការប្រើប្រាស់មិនទាន់សកម្មសម្រាប់គណនីនេះទេ សូមរៀបចំវា ឬធ្វើបច្ចុប្បន្នភាពវិធីបង់ប្រាក់ នៅលើទំព័រ ការតភ្ជាប់។ 410application/json- កំណែ API ដែលប្រើឆ្លើយសំណើនេះត្រូវបានបញ្ឈប់ហើយ។ សូមផ្ញើកំណែដែលគាំទ្រនៅក្នុង
Lingara-Versionឬភ្ជាប់ម៉ាស៊ីនភ្ញៀវទៅកំណែផ្សេង។ 4XXapplication/json- សំណើត្រូវបានបដិសេធ។
codeប្រាប់មូលហេតុ ហើយerrorពន្យល់វាជាពាក្យ។ 503application/json · text/plain- សេវាកម្មមិនអាចប្រើបានជាបណ្តោះអាសន្ន; សូមព្យាយាមម្តងទៀតបន្ទាប់ពីចំនួនវិនាទីក្នុង
Retry-After។ ក្នុងពេលថែទាំ ខ្លឹមសារជាអត្ថបទធម្មតា មិនមែនជាស្រោមកំហុសទេ។ 5XXapplication/json- សំណើត្រូវបានបដិសេធ។
codeប្រាប់មូលហេតុ ហើយerrorពន្យល់វាជាពាក្យ។
codestringចាំបាច់មូលហេតុដែលសំណើត្រូវបានបដិសេធ ជាកូដថេរសម្រាប់បែងចែកតក្កវិជ្ជា៖ ឧទាហរណ៍
insufficient_scope(403),rate_limited(429) ហើយសម្រាប់ក្លាយអិនត៍ដែលគិតថ្លៃតាមការប្រើប្រាស់spend_cap_reached(402) និងmetered_billing_inactive(402)។errorstringចាំបាច់
ឧទាហរណ៍
ចូលចិត្តបណ្ណាល័យមែនទេ? សូមមើលផ្នែកបណ្ណាល័យ។
ឧទាហរណ៍ស្ទ្រីម
event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}
event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好,我叫小明。","translation":"Hello, my name is Xiaoming."}}
event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}
event: done
data: {}ប្រសិនបើការបកប្រែ និងឯកសារយោងជាភាសាអង់គ្លេសខុសគ្នា ឯកសារយោងជាភាសាអង់គ្លេសគឺជាឯកសារដែលត្រឹមត្រូវ។