Model text embedding mengonversi data teks menjadi vektor numerik untuk tugas-tugas lanjutan seperti pencarian semantik, rekomendasi, pengelompokan, dan kategorisasi.
Ikhtisar model
Singapura
Model | Dimensi vektor | Jumlah Maksimum Baris | Maksimum token per baris (Catatan) | Harga (per juta token input) | Bahasa yang didukung | Kuota gratis(Catatan) |
text-embedding-v4 Bagian dari seri Qwen3-Embedding | 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, 64 | 10 | 8.192 | $0,07 | Bahasa Tiongkok, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan 100+ bahasa utama lainnya | 1 juta token Berlaku selama 90 hari setelah Anda mengaktifkan Model Studio. |
text-embedding-v3 | 1.024 (default), 768, 512 | Bahasa Tiongkok, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan 50+ bahasa utama lainnya | 500.000 token Masa berlaku: 90 hari setelah Anda mengaktifkan Model Studio |
Beijing
Nama model | Dimensi vektor | Jumlah Maksimum Baris | Maksimum token per baris | Harga (per juta token input) | Bahasa yang didukung |
text-embedding-v4 Bagian dari seri Qwen3-Embedding | 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, 64 | 10 | 8.192 | $0,072 | Bahasa Tiongkok, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan 100+ bahasa utama lainnya serta beberapa bahasa pemrograman |
Untuk informasi lebih lanjut mengenai batas laju model, lihat Batas laju.
Persiapan
Jika Anda terbiasa dengan ekosistem OpenAI, Anda dapat menggunakan API kompatibel OpenAI untuk migrasi cepat. API DashScope menyediakan fitur eksklusif tambahan. Pilih API yang paling sesuai dengan kebutuhan Anda.
Anda harus mendapatkan Kunci API dan mengatur Kunci API sebagai variabel lingkungan. Jika Anda menggunakan SDK untuk melakukan panggilan, Anda juga harus menginstal SDK DashScope.
Kompatibel dengan OpenAI
base_url untuk dikonfigurasi pada panggilan SDK:
Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1
Titik akhir untuk dikonfigurasi pada panggilan HTTP:
Singapura: POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/embeddings
Tiongkok (Beijing): POST https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings
Isi permintaan | String inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings Daftar string inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings File inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings Ganti 'texts_to_embedding.txt' dengan nama file atau jalur Anda. |
model Model yang akan dipanggil. Pilih nama model dari tabel Ikhtisar model. | |
input Teks input yang akan di-embedding, yang dapat berupa string, daftar string, atau file di mana setiap baris dianggap sebagai teks terpisah. Batas teks:
| |
dimensions Dimensi vektor. Nilainya harus salah satu dari berikut: 2048 (hanya untuk text-embedding-v4), 1536 (hanya untuk text-embedding-v4), 1024, 768, 512, 256, 128, atau 64. Nilai default adalah 1024. | |
encoding_format Format embedding yang dikembalikan. Hanya format |
Objek respons | Respons suksesRespons kesalahan |
data Data keluaran untuk tugas tersebut. | |
model Model yang dipanggil. | |
object string Jenis data yang dikembalikan oleh panggilan. Nilai default adalah list. | |
usage | |
id string ID permintaan unik yang dapat digunakan untuk melacak dan memecahkan masalah permintaan. |
DashScope
base_url untuk dikonfigurasi pada panggilan SDK:
Singapura: https://dashscope-intl.aliyuncs.com/api/v1
Tiongkok (Beijing): https://dashscope.aliyuncs.com/api/v1
Titik akhir untuk panggilan HTTP:
Singapura: POST https://dashscope-intl.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding
Tiongkok (Beijing): POST https://dashscope.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding
Isi permintaan | String inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding Daftar string inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding File inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), gunakan Kunci API untuk wilayah tersebut dan ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding Ganti 'texts_to_embedding.txt' dengan nama file atau jalur Anda. |
model Model yang akan dipanggil. Pilih nama model dari tabel Ikhtisar model. | |
input Teks input dapat berupa string, daftar string, atau file. Jika input berupa file, setiap baris dianggap sebagai teks terpisah yang akan di-embedding. Batas teks:
| |
text_type Vektor teks dapat digunakan untuk tugas lanjutan seperti pengambilan, pengelompokan, dan kategorisasi. Untuk tugas asimetris seperti pengambilan, kami merekomendasikan agar Anda membedakan antara kueri dan dokumen untuk mencapai hasil yang lebih baik. Untuk tugas simetris seperti pengelompokan dan kategorisasi, Anda dapat menggunakan nilai default | |
dimension Dimensi vektor. Nilainya harus salah satu dari berikut: 2048 (hanya untuk text-embedding-v4), 1536 (hanya untuk text-embedding-v4), 1024, 768, 512, 256, 128, atau 64. Nilai default adalah 1024. | |
output_type Menentukan apakah akan menghasilkan representasi vektor jarang. Parameter ini hanya berlaku untuk model text-embedding-v3 dan text-embedding-v4. Nilai yang valid adalah dense, sparse, dan dense&sparse. Nilai default adalah dense, yang hanya mengembalikan vektor padat. | |
instruct Deskripsi tugas kustom. Parameter ini hanya berlaku ketika Anda menggunakan model |
Objek respons | Respons suksesRespons kesalahan |
status_code Kode status. Nilai 200 menunjukkan permintaan berhasil. | |
request_id ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan memecahkan masalah permintaan. | |
code Jika permintaan gagal, parameter ini menunjukkan kode kesalahan. Jika permintaan berhasil, parameter ini kosong. | |
message Jika permintaan gagal, parameter ini menunjukkan pesan kesalahan detail. Jika permintaan berhasil, parameter ini kosong. | |
output Data keluaran untuk tugas tersebut. | |
usage |
Kode kesalahan
Jika pemanggilan model gagal dan pesan kesalahan dikembalikan, lihat Pesan kesalahan untuk informasi tentang cara menyelesaikan masalah tersebut.