Alibaba Cloud Model Studio:カスタム語彙

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"},
]


# 語彙を作成
service = VocabularyService()
vocabulary_id = service.create_vocabulary(
      prefix=prefix,
      target_model=target_model,
      vocabulary=my_vocabulary)

print(f"your vocabulary id is {vocabulary_id}")

# 語彙を使用してファイルを認識
recognition = Recognition(model=target_model,
                          format='wav',
                          sample_rate=16000,
                          callback=None,
                          vocabulary_id=vocabulary_id,
                          language_hints=['zh'])  # language_hints パラメーターは、paraformer-v2 および 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";
        // 語彙を準備
        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);
        }
        // 語彙を作成
        VocabularyService service = new VocabularyService(apiKey);
        Vocabulary myVoc = service.createVocabulary(targetModel, "prefix", vocabulary);
        System.out.println("your vocabulary id is " + myVoc.getVocabularyId());
        // 語彙を使用してファイルを認識
        Recognition recognizer = new Recognition();
        RecognitionParam param =
                RecognitionParam.builder()
                        .model(targetModel)
                        .format("wav")
                        .sampleRate(16000)
                        .apiKey(apiKey)
                        .vocabularyId(myVoc.getVocabularyId())
                        // language_hints パラメーターは、paraformer-v2 および 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:
    '''
    語彙を作成します。
    param: target_model 語彙の音声認識モデルのバージョン。
    param: prefix 語彙のカスタムプレフィックス。10 文字未満の小文字の英数字で構成する必要があります。
    param: vocabulary 語彙の辞書。
    return: 語彙識別子、vocabulary_id。
    '''

/**
 * 新しい語彙を作成します。
 *
 * @param targetModel 語彙の音声認識モデルのバージョン。
 * @param prefix 語彙のカスタムプレフィックス。10 文字未満の小文字の英数字で構成する必要があります。
 * @param vocabulary 語彙リスト。
 * @return 語彙オブジェクト。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
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]:
    '''
    作成されたすべての語彙をクエリします。
    param: prefix カスタムプレフィックス。指定した場合、このプレフィックスを持つ語彙識別子のリストのみを返します。
    param: page_index クエリするページインデックス。
    param: page_size ページサイズ。
    return: 語彙識別子のリスト。
    '''

/**
 * 作成されたすべての語彙をクエリします。デフォルトのページインデックスは 0、デフォルトのページサイズは 10 です。
 *
 * @param prefix 語彙のカスタムプレフィックス。
 * @return 語彙オブジェクトの配列。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
public Vocabulary[] listVocabulary(String prefix)
    throws NoApiKeyException, InputRequiredException

/**
 * 作成されたすべての語彙をクエリします。
 *
 * @param prefix 語彙のカスタムプレフィックス。
 * @param pageIndex クエリするページインデックス。
 * @param pageSize ページサイズ。
 * @return 語彙オブジェクトの配列。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
public Vocabulary[] listVocabulary(String prefix, int pageIndex, int pageSize)
    throws NoApiKeyException, InputRequiredException

def query_vocabulary(self, vocabulary_id: str) -> List[dict]:
    '''
    語彙の内容を取得します。
    param: vocabulary_id 語彙識別子。
    return: 語彙。
    '''

/**
 * 特定の語彙をクエリします。
 *
 * @param vocabularyId クエリする語彙。
 * @return 語彙オブジェクト。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
public Vocabulary queryVocabulary(String vocabularyId)
    throws NoApiKeyException, InputRequiredException

def update_vocabulary(self, vocabulary_id: str, vocabulary: List[dict]) -> None:
    '''
    既存の語彙を新しい語彙に置き換えます。
    param: vocabulary_id 置き換える語彙の識別子。
    param: vocabulary 新しい語彙。
    '''

/**
 * 語彙を更新します。
 *
 * @param vocabularyId 更新する語彙。
 * @param vocabulary 語彙オブジェクト。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
public void updateVocabulary(String vocabularyId, JsonArray vocabulary)
    throws NoApiKeyException, InputRequiredException

def delete_vocabulary(self, vocabulary_id: str) -> None:
    '''
    語彙を削除します。
    param: vocabulary_id 削除する語彙の識別子。
    '''

/**
 * 語彙を削除します。
 *
 * @param vocabularyId 削除する語彙。
 * @throws NoApiKeyException API キーが空の場合。
 * @throws InputRequiredException 必須パラメーターが空の場合。
 */
public void deleteVocabulary(String vocabularyId)
    throws NoApiKeyException, InputRequiredException