Model embedding Alibaba Cloud Model Studio kompatibel dengan API OpenAI. Untuk memigrasikan aplikasi OpenAI yang sudah ada ke Model Studio, Anda hanya perlu menyesuaikan tiga parameter berikut:
-
base_url: Ganti dengan
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.Untuk wilayah lainnya, sesuaikan base_url:
-
api_key: Ganti dengan Kunci API Model Studio.
-
model: Ganti dengan nama model dari daftar di bawah ini.
PentingModel Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing), Singapura, dan China (Hong Kong). Domain khusus baru ini menghadirkan performa lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan migrasi ke domain berikut:
- China (Beijing): dari
https://dashscope.aliyuncs.comkehttps://{WorkspaceId}.cn-beijing.maas.aliyuncs.com - Singapura: dari
https://dashscope-intl.aliyuncs.comkehttps://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com - China (Hong Kong): dari
https://cn-hongkong.dashscope.aliyuncs.comkehttps://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com
{WorkspaceId} adalah ID ruang kerja Anda, yang dapat ditemukan pada halaman Detail Ruang Kerja di Konsol Model Studio. Domain lama tetap berfungsi sepenuhnya.
Model yang didukung
Singapura
| Model | Dimensi embedding | Baris maksimum | Maksimum token per baris (Catatan) | Harga (per 1M token input) | Bahasa yang didukung | Kuota gratis (Catatan) |
|---|---|---|---|---|---|---|
text-embedding-v4
| 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, atau 64 | 10 | 8.192 | $0,07 | Lebih dari 100 bahasa utama, seperti Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, dan Rusia | 1 juta token Berlaku selama 90 hari setelah aktivasi Model Studio |
text-embedding-v3 | 1.024 (default), 768, atau 512 | Lebih dari 50 bahasa utama, seperti Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, dan Rusia | 500.000 token Berlaku selama 90 hari setelah aktivasi Model Studio |
China (Beijing)
| Model | Dimensi embedding | Baris maksimum | Maksimum token per baris (Catatan) | Harga (per 1M token input) | Bahasa yang didukung |
|---|---|---|---|---|---|
text-embedding-v4
| 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, atau 64 | 10 | 8.192 | $0,072 | Lebih dari 100 bahasa utama, seperti Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, dan Rusia, serta beberapa bahasa pemrograman |
China (Hong Kong)
| Model | Dimensi embedding | Baris maksimum | Maksimum token per baris (Catatan) | Harga (per 1M token input) | Bahasa yang didukung |
|---|---|---|---|---|---|
text-embedding-v4 | 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, atau 64 | 10 | 8.192 | $0,07 | Lebih dari 100 bahasa utama, seperti Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, dan Rusia, serta beberapa bahasa pemrograman |
Model embedding multimodal, seperti qwen3-vl-embedding dan seri tongyi-embedding-vision, tidak mendukung API kompatibel OpenAI. Lihat Embedding Multimodal.
Cara menggunakan
Contoh pemanggilan
Bagian ini menyediakan contoh input string menggunakan Python (OpenAI SDK) dan cURL (HTTP). Untuk contoh yang menggunakan bahasa pemrograman lain atau metode input lainnya, lihat Memulai text embedding.
OpenAI SDK
Untuk memanggil layanan menggunakan OpenAI SDK, Anda harus terlebih dahulu menginstal OpenAI SDK.
import os
from openai import OpenAI
def get_response():
client = OpenAI(
# Kunci API berbeda berdasarkan wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # Jika Anda belum mengonfigurasi variabel lingkungan, ganti nilai ini dengan Kunci API Anda.
# base_url layanan Model Studio. Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.embeddings.create(
model="text-embedding-v3", # Jika Anda menggunakan model di wilayah China (Beijing), ganti nama model dengan text-embedding-v4.
input='The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.',
encoding_format="float"
)
print(completion.model_dump_json())
if __name__ == '__main__':
get_response()
HTTP
Kirim panggilan antarmuka
Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
China (Beijing): POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings
Panggil dari command line
# Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "text-embedding-v3",
"input": "The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.",
"encoding_format": "float"
}'
Hasil berikut dikembalikan setelah Anda menjalankan kode:
Hasil
{
"data": [
{
"embedding": [
0.0023064255,
-0.009327292,
....
-0.0028842222
],
"index": 0,
"object": "embedding"
}
],
"model":"text-embedding-v3",
"object":"list",
"usage":{"prompt_tokens":23,"total_tokens":23},
"id":"f62c2ae7-0906-9758-ab34-47c5764f07e2"
}
Contoh respons error
Jika terjadi error permintaan akses, penyebabnya ditunjukkan oleh parameter code dan message dalam tanggapan.
{
"error": {
"message": "Incorrect API key provided. ",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}
Referensi API
Kode error
Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode error untuk penyelesaiannya.