Skip to main content

Referensi SDK Python hotwords kustom

Gunakan SDK Python untuk membuat, menampilkan daftar, mengkueri, memperbarui, dan menghapus kosakata kustom untuk pengenalan ucapan.

Alibaba Cloud Model Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing) dan Singapura. Domain khusus baru ini memberikan performa unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan migrasi ke domain berikut:
  • China (Beijing): dari dashscope.aliyuncs.com ke {WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapura: dari dashscope-intl.aliyuncs.com ke {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya. Domain lama tetap berfungsi sepenuhnya.
Panduan pengguna: Tingkatkan akurasi pengenalan.
Kosakata kustom hanya didukung di ruang kerja primary. Sub-ruang kerja tidak mendukung fitur ini.

Endpoint

SDK terhubung ke endpoint China (Beijing) secara default. Untuk menggunakan wilayah lain, tentukan parameter region saat membuat dashscope.Client (misalnya, ap-southeast-1 untuk wilayah Singapura).
  • Singapura
  • China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya.
Untuk beralih ke wilayah Singapura:
import os
import dashscope

# Tentukan wilayah saat membuat Client
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)
Catatan:
  • Kunci API berbeda antar wilayah. Gunakan Kunci API yang sesuai dengan wilayah Anda.
  • Pengaturan wilayah adalah pengaturan tingkat instans dashscope.Client dan hanya memengaruhi panggilan API yang dilakukan melalui client tersebut.

client.audio.vocabularies

Sumber daya: sumber daya client.audio.vocabularies dari sebuah instans dashscope.Client Deskripsi: Membuat, menampilkan daftar, mengkueri, memperbarui, dan menghapus kosakata kustom.

Konstruktor

import os
import dashscope

client = dashscope.Client(
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)
Jika api_key tidak diberikan, SDK secara otomatis membaca nilai variabel lingkungan DASHSCOPE_API_KEY.

create() - Buat kosakata kustom

Signature metode:
def create(
    self,
    *,
    target_model: str,
    prefix: str,
    vocabulary: List[dict]) -> Vocabulary
Parameter:

Parameter

Tipe

Wajib

Deskripsi

target_model

str

Ya

Model pengenalan ucapan yang menggunakan kosakata ini. Nilai ini harus sesuai dengan model yang Anda tentukan saat memanggil API pengenalan ucapan.

prefix

str

Ya

Awalan kustom untuk kosakata. Hanya huruf kecil dan angka yang diizinkan, dengan panjang maksimum 10 karakter.

vocabulary

List[dict]

Ya

Daftar hotword. Setiap entri adalah dict dengan bidang text, weight, dan lang.

Untuk informasi selengkapnya, lihat Struktur kamus hotword.

Nilai kembalian:

Jenis

Deskripsi

Vocabulary

Objek kosakata. Gunakan bidang vocabulary_id untuk mendapatkan ID kosakata.

list() - Tampilkan daftar kosakata kustom

Memetakan ke API HTTP action: list_vocabulary. Signature metode:
def list(
    self,
    *,
    prefix: str = None,
    page_index: int = 0,
    page_size: int = 10) -> VocabularyList
Parameter:

Parameter

Tipe

Wajib

Deskripsi

prefix

str

Tidak

Awalan kustom dari kosakata. Jika ditentukan, hanya kosakata dengan awalan ini yang dikembalikan.

page_index

int

Tidak

Nomor halaman, dimulai dari 0.

Nilai default: 0.

page_size

int

Tidak

Jumlah entri per halaman.

Nilai default: 10.

Nilai kembalian:

Tipe

Deskripsi

VocabularyList

Objek daftar kosakata terpaginasi. Bidang vocabularies adalah daftar kosakata, masing-masing berisi vocabulary_id, gmt_create, gmt_modified, dan status.

Bidang yang dikembalikan oleh list():

Bidang

Tipe

Deskripsi

vocabulary_id

str

ID kosakata.

gmt_create

str

Waktu pembuatan.

gmt_modified

str

Waktu modifikasi terakhir.

status

str

Status:

  • OK: Siap.

  • UNDEPLOYED: Tidak tersedia.

get() - Kueri kosakata kustom

Memetakan ke query_vocabulary() pada SDK 1.x. Signature metode:
def get(
    self,
    vocabulary_id: str) -> Vocabulary
Parameter:

Parameter

Tipe

Wajib

Deskripsi

vocabulary_id

str

Ya

ID kosakata kustom yang akan dikueri.

Nilai kembalian:

Tipe

Deskripsi

Vocabulary

Objek detail kosakata yang berisi vocabulary, target_model, gmt_create, gmt_modified, dan status.

Bidang yang dikembalikan oleh get():

Bidang

Tipe

Deskripsi

vocabulary

List[dict]

Konten daftar hotword.

target_model

str

Model pengenalan ucapan yang menggunakan kosakata ini. Nilai ini harus sesuai dengan model yang Anda tentukan saat memanggil API pengenalan ucapan.

gmt_create

str

Waktu pembuatan.

gmt_modified

str

Waktu modifikasi terakhir.

status

str

Status:

  • OK: Siap.

  • UNDEPLOYED: Tidak tersedia.

update() - Perbarui kosakata kustom

Signature metode:
def update(
    self,
    vocabulary_id: str,
    *,
    vocabulary: List[dict]) -> JobStatus
Parameter:

Parameter

Tipe

Wajib

Deskripsi

vocabulary_id

str

Ya

ID kosakata yang akan diperbarui.

vocabulary

List[dict]

Ya

Kosakata baru. Ini sepenuhnya menggantikan entri yang ada.

Nilai kembalian: Objek JobStatus, yang bidang status-nya menunjukkan status operasi.

delete() - Hapus kosakata kustom

Signature metode:
def delete(
    self,
    vocabulary_id: str) -> JobStatus
Parameter:

Parameter

Tipe

Wajib

Deskripsi

vocabulary_id

str

Ya

ID kosakata yang akan dihapus.

Nilai kembalian: Objek JobStatus, yang bidang status-nya menunjukkan status operasi.

Struktur kamus hotword

Bidang dalam setiap dict kosakata:

Bidang

Type

Wajib

Deskripsi

text

str

Ya

Teks entri kosakata.

Bahasa teks harus didukung oleh model yang dipilih. Bahasa yang didukung bervariasi tergantung model.

Gunakan kata aktual, bukan kombinasi karakter arbitrer, untuk meningkatkan akurasi pengenalan.

Panjang maksimum: 15 karakter untuk teks yang mencakup karakter non-ASCII, atau 7 kata yang dipisahkan spasi untuk teks ASCII saja.

weight

int

Ya

Bobot entri kosakata. Nilai yang direkomendasikan: 4.

Nilai valid: 1 hingga 5.

Jika akurasi pengenalan tidak membaik, tingkatkan bobotnya. Bobot yang terlalu tinggi dapat mengurangi akurasi pengenalan kata lain.

lang

str

Tidak

Kode bahasa audio yang akan dikenali. Saat diatur, sistem meningkatkan pengenalan entri kosakata dalam bahasa yang ditentukan. Jika Anda tidak dapat menentukan bahasa sebelumnya, biarkan parameter ini tidak diatur. Model akan mendeteksi bahasa secara otomatis.

Nilai valid (bervariasi tergantung model):

  • Paraformer:

    • zh: Chinese

    • en: English

    • ja: Japanese

    • yue: Cantonese

    • ko: Korean

    • de: German

    • fr: French

    • ru: Russian

  • Fun-ASR:

    • zh: Chinese

    • en: English

    • ja: Japanese

Kode contoh

Semua contoh membaca Kunci API dari variabel lingkungan.

Buat kosakata kustom

import os
import dashscope

# Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Jika tidak ada variabel lingkungan yang dikonfigurasi, atur langsung Kunci API Anda: api_key="sk-xxx"
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    # Konfigurasi berikut untuk wilayah Singapura (ap-southeast-1). Saat memanggil, ganti "{WorkspaceId}" dengan workspace ID Anda yang sebenarnya. Konfigurasi bervariasi tergantung wilayah.
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)

prefix = 'testpfx'
target_model = "fun-asr"

my_vocabulary = [
    {"text": "Seediq Bale", "weight": 4}
]

# Buat kosakata
vocabulary = client.audio.vocabularies.create(
    prefix=prefix,
    target_model=target_model,
    vocabulary=my_vocabulary)

print(f"Vocabulary ID: {vocabulary.vocabulary_id}")

Tampilkan daftar kosakata kustom

import json
import os
import dashscope

# Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Jika tidak ada variabel lingkungan yang dikonfigurasi, atur langsung Kunci API Anda: api_key="sk-xxx"
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    # Konfigurasi berikut untuk wilayah Singapura (ap-southeast-1). Saat memanggil, ganti "{WorkspaceId}" dengan workspace ID Anda yang sebenarnya. Konfigurasi bervariasi tergantung wilayah.
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)

result = client.audio.vocabularies.list()
print(f"Vocabularies: {json.dumps(result.vocabularies)}")

Kueri kosakata kustom

import json
import os
import dashscope

# Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Jika tidak ada variabel lingkungan yang dikonfigurasi, atur langsung Kunci API Anda: api_key="sk-xxx"
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    # Konfigurasi berikut untuk wilayah Singapura (ap-southeast-1). Saat memanggil, ganti "{WorkspaceId}" dengan workspace ID Anda yang sebenarnya. Konfigurasi bervariasi tergantung wilayah.
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)

# Ganti dengan ID kosakata yang sebenarnya saat mengkueri
vocabulary = client.audio.vocabularies.get("vocab-testpfx-xxx")
print(f"Vocabulary: {json.dumps(vocabulary.vocabulary, ensure_ascii=False)}")

Perbarui kosakata kustom

import os
import dashscope

# Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Jika tidak ada variabel lingkungan yang dikonfigurasi, atur langsung Kunci API Anda: api_key="sk-xxx"
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    # Konfigurasi berikut untuk wilayah Singapura (ap-southeast-1). Saat memanggil, ganti "{WorkspaceId}" dengan workspace ID Anda yang sebenarnya. Konfigurasi bervariasi tergantung wilayah.
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)

my_vocabulary = [
    {"text": "Seediq Bale", "weight": 4, "lang": "en"}
]
# Ganti dengan ID kosakata yang sebenarnya
result = client.audio.vocabularies.update("vocab-testpfx-xxx", vocabulary=my_vocabulary)
print(f"Status pembaruan: {result.status}")

Hapus kosakata kustom

import os
import dashscope

# Kunci API untuk wilayah Singapura dan Beijing berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Jika tidak ada variabel lingkungan yang dikonfigurasi, atur langsung Kunci API Anda: api_key="sk-xxx"
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    # Konfigurasi berikut untuk wilayah Singapura (ap-southeast-1). Saat memanggil, ganti "{WorkspaceId}" dengan workspace ID Anda yang sebenarnya. Konfigurasi bervariasi tergantung wilayah.
    workspace='{WorkspaceId}',
    region='ap-southeast-1',
)

# Ganti dengan ID tabel kosakata yang sebenarnya
result = client.audio.vocabularies.delete("vocab-testpfx-xxxx")
print(f"Status penghapusan: {result.status}")