Skip to main content
Lebih Banyak Tentang Model

Pemanggilan model di sub-ruang kerja

Dengan menggunakan Qwen-Plus sebagai contoh, topik ini menjelaskan cara memanggil model melalui API di sub-ruang kerja (ruang kerja non-default).

Skenario

  • Mengontrol model yang dapat dipanggil oleh pengguna tertentu: Kunci API untuk ruang kerja default dapat memanggil semua model, sehingga memberikan izin yang berlebihan. Untuk mengontrol model yang dapat dipanggil oleh pengguna RAM, tambahkan pengguna tersebut ke sub-ruang kerja, berikan izin hanya untuk model yang diperlukan, dan minta mereka menggunakan kunci API dari ruang kerja tersebut.
  • Mengalokasikan biaya pemanggilan model: Penggunaan ruang kerja default untuk beberapa layanan atau skenario menyulitkan pembedaan biaya pemanggilan model masing-masing. Buat sub-ruang kerja terpisah untuk setiap layanan atau skenario guna menghasilkan tagihan terpisah dan menyederhanakan alokasi biaya.

Prasyarat

  1. Dapatkan kunci API untuk sub-ruang kerja: Untuk memanggil API model besar, buat kunci API di sub-ruang kerja dan tetapkan sebagai variabel lingkungan bernama DASHSCOPE_API_KEY.
  2. Tetapkan izin pemanggilan model (wajib untuk model standar): Untuk memanggil standard model, seperti qwen-plus, dengan kunci API dari sub-ruang kerja, Anda harus terlebih dahulu menetapkan izin pemanggilan model untuk sub-ruang kerja tersebut.
  3. Pilih bahasa pengembangan: Pilih bahasa dan SDK yang Anda kuasai untuk memanggil API model besar.

Memanggil model

OpenAI

  • Singapore
  • China (Beijing)
SDK base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1HTTP endpoint: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions
Contoh ini menunjukkan cara memanggil model standar qwen-plus di sub-ruang kerja menggunakan metode kompatibel OpenAI. Berbeda dengan pemanggilan di ruang kerja default, Anda harus menggunakan kunci API dari sub-ruang kerja.
  • Python (SDK)
  • Java (SDK)
  • Node.js (SDK)
  • Go (SDK)
  • C# (HTTP)
  • PHP (HTTP)
  • curl (HTTP)
import os
from openai import OpenAI

client = OpenAI(
    # Jika variabel lingkungan belum ditetapkan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx"
    # Kunci API untuk wilayah Singapura dan Beijing berbeda. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # base_url ini untuk wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Untuk model di wilayah Beijing, gunakan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    # Contoh ini menggunakan qwen-plus. Anda dapat menggantinya dengan nama model lain sesuai kebutuhan. Untuk daftar model, lihat: https://www.alibabacloud.com/help/model-studio/getting-started/models
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
    # Parameter enable_thinking mengontrol proses berpikir untuk model Qwen3 (default True untuk versi open source, False untuk versi komersial).
    # Saat menggunakan model Qwen3 open source tanpa mengaktifkan keluaran streaming, hapus komentar baris berikut untuk menghindari error.
    # extra_body={"enable_thinking": False},
)
print(completion.model_dump_json())

DashScope

  • Singapore region
  • China (Beijing)
HTTP endpoint:
  • Model bahasa besar Qwen: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
  • Model Qwen-VL/OCR: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
base_url untuk panggilan SDK adalah:
  • Python
  • Java
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
Contoh ini menunjukkan cara memanggil model qwen-plus di sub-ruang kerja menggunakan DashScope. Perbedaan utama dibandingkan penggunaan ruang kerja default adalah bahwa Anda harus menggunakan kunci API untuk sub-ruang kerja.
  • Python (SDK)
  • Java (SDK)
  • PHP (HTTP)
  • Node.js (HTTP)
  • C# (HTTP)
  • Go (HTTP)
  • curl (HTTP)
import os
import dashscope

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
# Baris sebelumnya menetapkan base_url untuk wilayah Singapura. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Jika Anda menggunakan model di wilayah China (Beijing), ganti base_url dengan: https://dashscope.aliyuncs.com/api/v1
messages = [
    {'role': 'system', 'content': 'You are a helpful assistant.'},
    {'role': 'user', 'content': 'Who are you?'}
]
response = dashscope.Generation.call(
    # Jika variabel lingkungan belum ditetapkan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx"
    # Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Untuk mendapatkan kunci API, lihat: https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    model="qwen-plus", # Contoh ini menggunakan qwen-plus. Anda dapat menggantinya dengan nama model lain sesuai kebutuhan. Untuk daftar model, lihat: https://www.alibabacloud.com/help/model-studio/getting-started/models
    messages=messages,
    result_format='message'
    )
print(response)

Kode error

Jika pemanggilan model mengembalikan error, lihat Pesan Error.

Langkah selanjutnya

Jelajahi lebih banyak model

Kode contoh menggunakan model qwen-plus. Model Studio juga mendukung model Qwen lainnya. Lihat Model untuk daftar model yang didukung dan referensi API-nya.

Penggunaan lanjutan

Kode contoh menunjukkan skenario tanya jawab dasar. Ikhtisar generasi teks mencakup fitur lanjutan API Qwen, termasuk keluaran streaming, output terstruktur, dan pemanggilan fungsi.

Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Realtime API
Penyematan Teks
TokenPlan
Model production