Gumawa ng listahan ng bokabularyo
Bersyon ng API 2026-10-affable-towhee
Nag-i-stream ng listahan ng mga salita sa hiniling na antas. Ipinapadala ng stream ang started kasama ang mga detalye ng listahan, isang item na event bawat salita, pagkatapos ay done. Hangga't hindi pa handa ang listahan, mga keepalive na komento lamang ang ipinapadala nito.
Mga scope vocab:generate
Mga parameter
Lingara-Versionheaderstringopsyonal- Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng
400na may code naapi_version_unknown. Inililista ngGET /v1/versionsang mga bersyon.
Katawan ng kahilingan application/json
levelintegerkailangansource_langstringkailangantarget_langstringkailangancountinteger | nullopsyonal
Mga tugon
200 Ang listahan, isang salita bawat event
Mga event ng stream text/event-stream
Nagpapadala ng keepalive na komento bawat 15 segundo.
-
startedVocabStarted -
metaVocabMetakailanganlevelintegerkailangansource_langstringkailangantarget_langstringkailanganframeworkstringkailangancountintegerkailanganai_generatedbooleankailangan
-
itemVocabItem -
wordstringkailanganpronunciationstring | nullopsyonalreadingstring | nullopsyonaltranslationstringkailanganexampleVocabExample | nullopsyonalsentencestringkailangantranslationstringkailangan
image_urlstring | nullopsyonal
-
doneDone Tinatapos ang stream -
errorStreamError Tinatapos ang stream -
Dumarating sa loob ng 200 na tugon. Naipadala na ang status line, kaya ang pagkabigo matapos mabuksan ang stream ay iniuulat bilang event na ito.
codestringkailanganmessagestringkailanganplan_idstring | nullopsyonal
Mga error
402application/json- Tinanggihan ang tawag ng isang metered client bago ito nakagastos ng anuman.
spend_cap_reached: naabot na ng client o ng account nito ang buwanang limitasyon sa paggastos; itaas ang limitasyon sa pahinang Mga integration.metered_billing_inactive: hindi aktibo ang usage billing para sa account na ito; i-set up ito, o i-update ang paraan ng pagbabayad, sa pahinang Mga integration. 410application/json- Itinigil na ang bersyon ng API na ginagamit sa pagsagot sa kahilingang ito. Magpadala ng suportadong bersyon sa
Lingara-Version, o i-pin ang client sa ibang bersyon. 4XXapplication/json- Tinanggihan ang kahilingan. Sinasabi ng
codekung bakit, at ipinapaliwanag ito ngerrorsa mga salita. 503application/json · text/plain- Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa
Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope. 5XXapplication/json- Tinanggihan ang kahilingan. Sinasabi ng
codekung bakit, at ipinapaliwanag ito ngerrorsa mga salita.
codestringkailanganKung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa
insufficient_scope(403),rate_limited(429) at, para sa isang metered client,spend_cap_reached(402) atmetered_billing_inactive(402).errorstringkailangan
Halimbawa
Mas gusto ang library? Tingnan ang seksyong Mga library.
Halimbawang stream
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: {}Kung magkaiba ang isang salin at ang sangguniang Ingles, ang sangguniang Ingles ang tama.