Lîsteyeke peyvan çêbike

Guhertoya API 2026-10-affable-towhee

post https://api.getlingara.com/v1/vocab/stream

Lîsteyeke peyvan li asta xwestî stream dike. Stream pêşî started bi hûrguliyên lîsteyê dişîne, ji bo her peyvê bûyereke item, paşê done. Heta ku lîste amade bibe, tenê şîroveyên keepalive dişîne.

Scope vocab:generate

Parametre

Lingara-Versionheaderstringvebijarkî: Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.

Naveroka daxwazê `application/json`

levelintegerpêwîst
source_langstringpêwîst
target_langstringpêwîst
countinteger | nullvebijarkî

Bersiv

200 Lîste, di her bûyerê de peyvek

Bûyerên streamê `text/event-stream`

Her 15 çirkeyan şîroveyeke keepalive dişîne.

started VocabStarted

metaVocabMetapêwîst

levelintegerpêwîst
source_langstringpêwîst
target_langstringpêwîst
frameworkstringpêwîst
countintegerpêwîst
ai_generatedbooleanpêwîst

item VocabItem

wordstringpêwîst

pronunciationstring | nullvebijarkî

readingstring | nullvebijarkî

translationstringpêwîst

exampleVocabExample | nullvebijarkî

sentencestringpêwîst
translationstringpêwîst

image_urlstring | nullvebijarkî

done Done Weşanê diqedîne

error StreamError Weşanê diqedîne

Di nav bersiva 200 de tê. Rêza rewşê berê hatiye şandin, ji ber vê yekê têkçûnek piştî vebûna weşanê wekî vê bûyerê tê ragihandin.

codestringpêwîst
messagestringpêwîst
plan_idstring | nullvebijarkî

Çewtî

402application/json: Bangeke klienteke pîvandî hat redkirin berî ku tiştek xerc bike. spend_cap_reached: klient an hesabê wê gihîştiye sînorê xercê yê mehane; sînor li rûpela Entegrasyon bilind bike. metered_billing_inactive: fatûrekirina li gorî bikaranînê ji bo vî hesabî ne çalak e; wê li rûpela Entegrasyon saz bike an rêbaza dayînê nû bike.
410application/json: Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.
4XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
503application/json · text/plain: Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.
5XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

codestringpêwîst: Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).
errorstringpêwîst

Mînak

curlTypeScriptRustGoJavaKotlinRubyPHP

curl

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

TypeScript

const stream = client.generateVocabulary({ level: 2, source_lang: "en", target_lang: "zh", count: 8 });
for await (const ev of stream) {
  if (ev.event === "item") console.log(ev.data.word, ev.data.translation);
}

Rust

use lingara::models::{GenerateVocabularyEvent, VocabRequest};
use std::num::NonZeroU8;

let request = VocabRequest { level: 2, source_lang: "en".into(), target_lang: "zh".into(), count: NonZeroU8::new(8) };
let mut stream = client.generate_vocabulary(&request).await?;
while let Some(event) = stream.next().await {
    if let GenerateVocabularyEvent::Item(item) = event? {
        println!("{} {}", item.word, item.translation);
    }
}

count := uint8(8)
s, err := client.GenerateVocabulary(ctx, lingara.VocabRequest{Level: 2, SourceLang: "en", TargetLang: "zh", Count: &count})
if err != nil {
	return err
}
defer s.Close()
for ev, err := range s.Events() {
	if err != nil {
		return err
	}
	if item, ok := ev.(lingara.GenerateVocabularyEventItem); ok {
		fmt.Println(item.Data.Word, item.Data.Translation)
	}
}

Java

import com.getlingara.client.model.GenerateVocabularyEvent;
import com.getlingara.client.model.VocabRequest;

VocabRequest request = new VocabRequest().level(2).sourceLang("en").targetLang("zh").count(8);
try (EventStream<GenerateVocabularyEvent> stream = client.generateVocabulary(request)) {
  for (GenerateVocabularyEvent event : stream) {
    if (event instanceof GenerateVocabularyEvent.Item item) {
      System.out.println(item.data().getWord() + " " + item.data().getTranslation());
    }
  }
}

Kotlin

import com.getlingara.kotlin.LingaraClient
import com.getlingara.kotlin.model.GenerateVocabularyEvent
import com.getlingara.kotlin.model.VocabRequest

val request = VocabRequest(level = 2, sourceLang = "en", targetLang = "zh", count = 8)
// The request is sent here; collect the stream once, inside use {}.
client.generateVocabulary(request).use { stream ->
    stream.collect { event ->
        when (event) {
            is GenerateVocabularyEvent.Item -> println("${event.data.word} ${event.data.translation}")
            is GenerateVocabularyEvent.Started -> Unit
        }
    }
}

Ruby

client.generate_vocabulary(level: 2, source_lang: "en", target_lang: "zh", count: 8) do |event|
  case event
  in Lingara::GenerateVocabularyEventItem => item then puts "#{item.data.word}: #{item.data.translation}"
  else nil
  end
end

PHP

use Lingara\Model\VocabRequest;
use Lingara\Stream\GenerateVocabularyEvent;

$request = new VocabRequest(['level' => 2, 'source_lang' => 'en', 'target_lang' => 'zh', 'count' => 8]);
foreach ($client->generateVocabulary($request) as $event) {
    if ($event instanceof GenerateVocabularyEvent\Item) {
        echo $event->data->getWord(), ': ', $event->data->getTranslation(), "\n";
    }
}

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.

Mînaka 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: {}

Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.