Alibaba Cloud Model Studio：Kosakata Kustom

import dashscope
from dashscope.audio.asr import *


dashscope.api_key = 'your-dashscope-api-key'
prefix = 'prefix'
target_model = "paraformer-realtime-v2"

my_vocabulary = [
    {"text": "Wu Yigong", "weight": 4, "lang": "zh"},
    {"text": "Confucius' Family", "weight": 4, "lang": "zh"},
]


# buat kosakata
service = VocabularyService()
vocabulary_id = service.create_vocabulary(
      prefix=prefix,
      target_model=target_model,
      vocabulary=my_vocabulary)

print(f"ID kosakata Anda adalah {vocabulary_id}")

# gunakan kosakata untuk mengenali file
recognition = Recognition(model=target_model,
                          format='wav',
                          sample_rate=16000,
                          callback=None,
                          vocabulary_id=vocabulary_id,
                          language_hints=['zh'])  # Parameter language_hints hanya didukung oleh model paraformer-v2 dan paraformer-realtime-v2.
result = recognition.call('your-audio-file.wav')
print(result.output)

package org.example.customization;

import com.alibaba.dashscope.audio.asr.recognition.Recognition;
import com.alibaba.dashscope.audio.asr.recognition.RecognitionParam;
import com.alibaba.dashscope.audio.asr.vocabulary.Vocabulary;
import com.alibaba.dashscope.audio.asr.vocabulary.VocabularyService;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;

import java.io.File;
import java.util.ArrayList;
import java.util.List;

public class VocabularySampleCodes {
    public static String apiKey = "your-dashscope-apikey";

    public static void main(String[] args) throws NoApiKeyException, InputRequiredException {
        String targetModel = "paraformer-realtime-v2";
        // siapkan kosakata
        class Hotword {
            String text;
            int weight;
            String lang;

            public Hotword(String text, int weight, String lang) {
                this.text = text;
                this.weight = weight;
                this.lang = lang;
            }
        }
        JsonArray vocabulary = new JsonArray();
        List<Hotword> wordList = new ArrayList<>();
        wordList.add(new Hotword("Wu Yigong", 4, "zh"));
        wordList.add(new Hotword("Confucius' Family", 4, "zh"));

        for (Hotword word : wordList) {
            JsonObject jsonObject = new JsonObject();
            jsonObject.addProperty("text", word.text);
            jsonObject.addProperty("weight", word.weight);
            jsonObject.addProperty("lang", word.lang);
            vocabulary.add(jsonObject);
        }
        // buat kosakata
        VocabularyService service = new VocabularyService(apiKey);
        Vocabulary myVoc = service.createVocabulary(targetModel, "prefix", vocabulary);
        System.out.println("ID kosakata Anda adalah " + myVoc.getVocabularyId());
        // gunakan kosakata untuk mengenali file
        Recognition recognizer = new Recognition();
        RecognitionParam param =
                RecognitionParam.builder()
                        .model(targetModel)
                        .format("wav")
                        .sampleRate(16000)
                        .apiKey(apiKey)
                        .vocabularyId(myVoc.getVocabularyId())
                        // Parameter language_hints hanya didukung oleh model paraformer-v2 dan paraformer-realtime-v2.
                        .parameter("language_hints", new String[] {"zh"})
                        .build();
        String result = recognizer.call(param, new File("your-local-audio-file.wav"));
        System.out.println(result);
        System.exit(0);
    }
}

service = VocabularyService(api_key="your-dashscope-apikey")

VocabularyService service = new VocabularyService("your-dashscope-apikey");

def create_vocabulary(self, target_model: str, prefix: str, vocabulary: List[dict]) -> str:
    '''
    Buat kosakata.
    param: target_model Versi model pengenalan ucapan untuk kosakata ini.
    param: prefix Awalan kustom untuk kosakata. Harus terdiri dari kurang dari 10 huruf kecil dan angka.
    param: vocabulary Kamus kosakata.
    return: Pengidentifikasi kosakata, vocabulary_id.
    '''

/**
 * Buat kosakata baru.
 *
 * @param targetModel Versi model pengenalan ucapan untuk kosakata ini.
 * @param prefix Awalan kustom untuk kosakata. Harus terdiri dari kurang dari 10 huruf kecil dan angka.
 * @param vocabulary Daftar kosakata.
 * @return Objek kosakata.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public Vocabulary createVocabulary(String targetModel, String prefix, JsonArray vocabulary)
    throws NoApiKeyException, InputRequiredException 

def list_vocabularies(self, prefix=None, page_index: int = 0, page_size: int = 10) -> List[dict]:
    '''
    Kueri semua kosakata yang telah dibuat.
    param: prefix Awalan kustom. Jika ditentukan, hanya mengembalikan daftar pengidentifikasi kosakata dengan awalan ini.
    param: page_index Indeks halaman yang dikueri.
    param: page_size Ukuran halaman.
    return: Daftar pengidentifikasi kosakata.
    '''

/**
 * Kueri semua kosakata yang telah dibuat. Indeks halaman default adalah 0, dan ukuran halaman default adalah 10.
 *
 * @param prefix Awalan kustom untuk kosakata.
 * @return Larik objek kosakata.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public Vocabulary[] listVocabulary(String prefix)
    throws NoApiKeyException, InputRequiredException

/**
 * Kueri semua kosakata yang telah dibuat.
 *
 * @param prefix Awalan kustom untuk kosakata.
 * @param pageIndex Indeks halaman yang dikueri.
 * @param pageSize Ukuran halaman.
 * @return Larik objek kosakata.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public Vocabulary[] listVocabulary(String prefix, int pageIndex, int pageSize)
    throws NoApiKeyException, InputRequiredException

def query_vocabulary(self, vocabulary_id: str) -> List[dict]:
    '''
    Dapatkan isi kosakata.
    param: vocabulary_id Identifier kosakata.
    return: Kosakata tersebut.
    '''

/**
 * Kueri kosakata tertentu.
 *
 * @param vocabularyId Kosakata yang akan dikueri.
 * @return Objek kosakata.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public Vocabulary queryVocabulary(String vocabularyId)
    throws NoApiKeyException, InputRequiredException

def update_vocabulary(self, vocabulary_id: str, vocabulary: List[dict]) -> None:
    '''
    Ganti kosakata yang ada dengan kosakata baru.
    param: vocabulary_id Pengidentifikasi kosakata yang akan diganti.
    param: vocabulary Kosakata baru.
    '''

/**
 * Perbarui kosakata.
 *
 * @param vocabularyId Kosakata yang akan diperbarui.
 * @param vocabulary Objek kosakata.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public void updateVocabulary(String vocabularyId, JsonArray vocabulary)
    throws NoApiKeyException, InputRequiredException

def delete_vocabulary(self, vocabulary_id: str) -> None:
    '''
    Hapus kosakata.
    param: vocabulary_id Identifier kosakata yang akan dihapus.
    '''

/**
 * Hapus kosakata.
 *
 * @param vocabularyId Kosakata yang akan dihapus.
 * @throws NoApiKeyException jika Kunci API kosong.
 * @throws InputRequiredException jika parameter yang diperlukan kosong.
 */
public void deleteVocabulary(String vocabularyId)
    throws NoApiKeyException, InputRequiredException