Alibaba Cloud Model Studio:Pilih wilayah dan mode penyebaran

Wilayah untuk layanan model adalah lokasi fisik titik akhirnya. Saat memilih wilayah, pertimbangkan faktor-faktor berikut:

• Latensi akses: Jarak fisik merupakan faktor utama yang memengaruhi waktu respons. Pilih wilayah yang secara geografis dekat dengan Anda dan pengguna akhir untuk meminimalkan latensi jaringan.

• Persyaratan kepatuhan: Pilih wilayah yang memenuhi persyaratan kediaman data Anda. Penyebaran Anda harus mematuhi hukum dan peraturan setempat.

• Ketersediaan fitur: Fitur dan model yang tersedia berbeda-beda di tiap wilayah. Untuk detailnya, lihat ketersediaan fitur berdasarkan wilayah dan daftar model yang tersedia.

Wilayah yang saat ini didukung: Singapura, AS (Virginia), Tiongkok (Beijing), Tiongkok (Hong Kong), Jerman (Frankfurt)

Seluruh data statis Anda disimpan di wilayah yang Anda pilih guna memenuhi persyaratan kediaman data.

Menggunakan model International dalam mode penyebaran

Konfigurasikan alamat permintaan, kunci API, dan nama model:

• Alamat permintaan (Base URL): Untuk mode penyebaran International yang di-host di wilayah Singapura, gunakan nama domain dashscope-intl.aliyuncs.com. Untuk API lainnya, lihat dokumentasi yang sesuai.

  • API OpenAI Chat Completions: https://<u>dashscope-intl.aliyuncs.com</u>/compatible-mode/v1

  • DashScope: https://<u>dashscope-intl.aliyuncs.com</u>/api/v1

• API key: Buka halaman Key Management (Singapore) untuk mendapatkan kunci API Anda.

• Nama model: Dari daftar Model, pilih model yang mendukung mode penyebaran ini.

Menggunakan model United States dalam mode penyebaran

Konfigurasikan alamat permintaan, kunci API, dan nama model:

• Alamat permintaan (Base URL): Untuk mode penyebaran AS di wilayah AS (Virginia), gunakan nama domaindashscope-us.aliyuncs.com. Untuk API lainnya, lihat dokumentasi yang sesuai.

  • OpenAI Chat Completions API: https://<u>dashscope-us.aliyuncs.com</u>/compatible-mode/v1

  • DashScope: https://<u>dashscope-us.aliyuncs.com</u>/api/v1

• API key: Buka halaman Key Management (Virginia) untuk mendapatkan kunci API Anda.

• Nama model: Dari daftar Model, pilih model untuk mode penyebaran AS (dengan akhiran -us).

Menggunakan model Global dalam mode penyebaran

Mode penyebaran global mendukung beberapa wilayah. Pilih wilayah berdasarkan kebutuhan bisnis Anda.

Menggunakan model Chinese Mainland dalam mode penyebaran

Menggunakan model Hong Kong (China) dalam mode penyebaran

Menggunakan model European Union dalam mode penyebaran

Tugas asinkron

Untuk tugas asinkron, seperti pembuatan gambar atau video, seluruh operasi berikutnya harus menggunakan nama domain layanan dan kunci API yang sama dengan yang digunakan saat membuat tugas tersebut. Jika tidak, permintaan akan gagal.

Contoh untuk mode penyebaran Global (wilayah AS). Untuk wilayah Jerman, gunakan {WorkspaceId}.eu-central-1.maas.aliyuncs.com:

# Buat tugas dalam mode penyebaran Global (wilayah AS) dengan nama domain layanan dashscope-us.aliyuncs.com
curl --location 'https://dashscope-us.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
    "model": "wan2.6-t2i",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "n": 1
    }
}'

# Contoh respons: {"output":{"task_id":"abc123..."},"request_id":"..."}

# Periksa status tugas. Anda harus menggunakan nama domain layanan yang sama.
curl -X GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

# [Error] Menggunakan nama domain layanan yang berbeda untuk permintaan ini akan menyebabkan error.
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"