Model text embedding tujuan umum mengonversi data teks menjadi vektor numerik untuk tugas-tugas downstream seperti pencarian semantik, rekomendasi, pengelompokan, dan klasifikasi.
Ikhtisar model
Singapura
Model | Dimensi penyematan | Baris maks | Token maksimum per baris (Catatan) | Harga (per 1M 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 Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan lebih dari 100 bahasa utama lainnya | 1 juta token Masa berlaku: 90 hari setelah Anda mengaktifkan Model Studio |
text-embedding-v3 | 1.024 (default), 768, 512 | Bahasa Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan lebih dari 50 bahasa utama lainnya | 500.000 token Masa berlaku: 90 hari setelah Anda mengaktifkan Model Studio |
Tiongkok (Beijing)
Model | Dimensi penyematan | Baris maks | Token maksimum per baris | Harga (per 1M 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 Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan lebih dari 100 bahasa utama lainnya, ditambah beberapa bahasa pemrograman |
Tiongkok (Hong Kong)
Model | Dimensi penyematan | Baris maks | Token maksimum per baris | Harga (per 1M 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,07 | Bahasa Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan lebih dari 100 bahasa utama lainnya, ditambah beberapa bahasa pemrograman |
Untuk batas laju model, lihat Pembatasan laju.
Prasyarat
Pengguna yang terbiasa dengan ekosistem OpenAI dapat menggunakan API yang kompatibel dengan OpenAI untuk migrasi cepat. API DashScope menyediakan fitur-fitur unik tambahan.
Buat Kunci API dan ekspor Kunci API sebagai variabel lingkungan. Jika Anda menggunakan SDK untuk melakukan panggilan, instal SDK DashScope.
Kompatibilitas OpenAI
base_url untuk dikonfigurasi pada panggilan SDK:
Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1
Tiongkok (Hong Kong): https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.
endpoint untuk dikonfigurasi pada panggilan HTTP:
Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.Tiongkok (Beijing): POST https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings
Tiongkok (Hong Kong): POST https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1/embeddings. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.
Domain lama Singapura https://dashscope-intl.aliyuncs.com dan domain Tiongkok (Hong Kong) https://cn-hongkong.dashscope.aliyuncs.com akan dihentikan. Migrasikan ke https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com (Singapura) dan https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com (Tiongkok (Hong Kong)) sesegera mungkin.
Isi permintaan | String inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), Anda harus menggunakan Kunci API dari wilayah tersebut dan mengganti URL dengan Daftar string inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), Anda harus menggunakan Kunci API dari wilayah tersebut dan mengganti URL dengan File inputPythonJavacurlJika Anda menggunakan model di wilayah Tiongkok (Beijing), Anda harus menggunakan Kunci API dari wilayah tersebut dan mengganti URL dengan Ganti 'texts_to_embedding.txt' dengan nama file atau jalur Anda. |
model Nama model yang akan dipanggil. Lihat tabel Ikhtisar model untuk nama-nama model. | |
input Teks input yang akan diproses. Input dapat berupa string, array string, atau file. Jika input berupa string, panjang maksimum adalah 8.192 token. Jika input berupa daftar string atau file, ukuran batch maksimum adalah 10 item (baris), dan setiap item (baris) dapat berisi hingga 8.192 token. | |
dimensions Dimensi vektor penyematan output. Harus salah satu dari nilai berikut: 2048 (hanya untuk | |
encoding_format Format penyematan yang dikembalikan. Saat ini, hanya |
Objek respons | Respons suksesRespons kesalahan |
data Daftar objek penyematan hasil. | |
model Nama model yang digunakan untuk panggilan ini. | |
object string Jenis objek. Nilainya selalu | |
usage | |
id string Identifikasi permintaan unik, digunakan untuk pelacakan dan troubleshooting. |
DashScope
base_url untuk panggilan SDK:
Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.Tiongkok (Beijing): https://dashscope.aliyuncs.com/api/v1
Tiongkok (Hong Kong): https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/api/v1. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.
Endpoint untuk panggilan HTTP:
Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.Tiongkok (Beijing): POST https://dashscope.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding
Tiongkok (Hong Kong): POST https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/api/v1/services/embeddings/text-embedding/text-embedding. Ganti
WorkspaceIddengan ID ruang kerja aktual Anda.
URL lama Tiongkok (Hong Kong) https://cn-hongkong.dashscope.aliyuncs.com/api/v1 akan segera ditinggalkan. Harap migrasikan ke URL baru https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/api/v1 sesegera mungkin.
Domain lama https://dashscope-intl.aliyuncs.com untuk wilayah Singapura akan segera ditinggalkan. Harap migrasikan ke domain baru https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com sesegera mungkin.
Badan 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. Ini adalah URL wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda berdasarkan wilayah. 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. Ini adalah URL wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda berdasarkan wilayah. 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. Ini adalah URL wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda berdasarkan wilayah. Ganti 'texts_to_embedding.txt' dengan nama file atau jalur Anda. |
model Model yang akan digunakan. Untuk daftar model yang tersedia, lihat tabel Ikhtisar model. | |
input Teks yang akan diproses. Input dapat berupa string, array string, atau file. String tunggal dapat mencapai 8.192 token. Daftar string atau file dapat berisi hingga 10 item (baris), dengan setiap item hingga 8.192 token. | |
text_type Saat melakukan panggilan HTTP, letakkan text_type di dalam objek Teks yang dikonversi menjadi penyematan dapat diterapkan pada tugas-tugas downstream seperti pengambilan, pengelompokan, dan klasifikasi. Untuk tugas asimetris seperti pengambilan, disarankan untuk membedakan antara teks kueri (query) dan teks dokumen (document) untuk mencapai performa pengambilan yang lebih baik. Untuk tugas simetris seperti pengindeksan, pengelompokan, dan klasifikasi, Anda cukup menggunakan nilai default sistem yaitu | |
dimension Saat melakukan panggilan HTTP, letakkan dimension di dalam objek Menentukan dimensi penyematan untuk vektor output. Nilai yang valid adalah 2048 (hanya untuk | |
output_type Saat melakukan panggilan HTTP, letakkan output_type di dalam objek Menentukan jenis vektor output. Parameter ini hanya berlaku untuk model | |
instruct Memberikan instruksi khusus untuk memandu model dalam memahami maksud kueri. Instruksi dalam bahasa Inggris direkomendasikan, karena biasanya meningkatkan performa sebesar 1% hingga 5%. |
Objek respons | Respons suksesRespons kesalahan |
status_code Kode status HTTP. Nilai 200 menunjukkan keberhasilan. | |
request_id Identifikasi unik untuk permintaan. Gunakan ID ini untuk melacak dan troubleshooting permintaan. | |
code Kode kesalahan yang dikembalikan jika permintaan gagal. Bidang ini kosong untuk permintaan yang berhasil. | |
message Pesan kesalahan rinci jika permintaan gagal. Bidang ini kosong untuk permintaan yang berhasil. | |
output Hasil dari tugas. | |
usage |
Kode kesalahan
Jika pemanggilan model gagal, lihat Pesan Kesalahan.