Kompatibel dengan OpenAI - Embedding - Alibaba Cloud Model Studio

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.

Model 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.com ke https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
Singapura: dari https://dashscope-intl.aliyuncs.com ke https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
China (Hong Kong): dari https://cn-hongkong.dashscope.aliyuncs.com ke https://{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
China (Beijing)
China (Hong Kong)

Model	Dimensi embedding	Baris maksimum	Maksimum token per baris (Catatan)	Harga (per 1M token input)	Bahasa yang didukung	Kuota gratis (Catatan)
text-embedding-v4 Qwen3-Embedding series	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 tokenBerlaku selama 90 hari setelah aktivasi Model Studio
text-embedding-v3	1.024 (default), 768, atau 512	10	8.192	$0,07	Lebih dari 50 bahasa utama, seperti Tionghoa, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, dan Rusia	500.000 tokenBerlaku selama 90 hari setelah aktivasi Model Studio

Model	Dimensi embedding	Baris maksimum	Maksimum token per baris (Catatan)	Harga (per 1M token input)	Bahasa yang didukung
text-embedding-v4 Qwen3-Embedding series	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

Model	Dimensi embedding	Baris maksimum	Maksimum token per baris (Catatan)	Harga (per 1M token input)	Bahasa yang didukung
text-embedding-v4 Qwen3-Embedding	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
HTTP

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()

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

Referensi API text embedding

Kode error

Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode error untuk penyelesaiannya.

​Model yang didukung

​Cara menggunakan

​Contoh pemanggilan

​Contoh respons error

​Referensi API