全部产品
Search

搜索本产品

    API Gateway：Buat layanan

    文档中心

    API Gateway：Buat layanan

    更新时间：Nov 10, 2025

    Daftarkan layanan yang sudah ada ke gerbang untuk mengaktifkan perutean dan memungkinkan gerbang mengambil titik akhir layanan. Gerbang AI mendukung penambahan layanan dari berbagai sumber, seperti layanan kontainer, alamat tetap, nama domain DNS, dan Function Compute.

    Prosedur

    Catatan

    Gerbang AI tidak memodifikasi permintaan Anda. Ketika permintaan diteruskan ke layanan backend yang menggunakan nama domain, gerbang tidak menulis ulang header Host menjadi nama domain yang dikonfigurasi.

    Gerbang menggunakan layanan untuk mendeteksi secara dinamis perubahan pada sumber daya backend. Hal ini memungkinkan pengelolaan terpadu atas perutean lalu lintas, administrasi, dan perlindungan keamanan. Gerbang AI mendukung pembuatan layanan dari sumber-sumber berikut: Layanan AI, Layanan Agen, Nama domain DNS, Alamat tetap, Layanan kontainer, Layanan Kubernetes SAE, Function Compute (FC), dan MSE Nacos.

    Layanan AI

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih AI Service.

      • Service Name: Masukkan nama kustom untuk layanan tersebut.

      • Large Model Provider: Penyedia yang didukung adalah Alibaba Cloud Model Studio, PAI-EAS, Deepseek, OpenAI Compatible, OpenAI, Azure, Gemini, Bedrock, Claude, Moonshot AI, Baichuan, Yi, Zhipu AI, Hunyuan, StepFun, Spark, Doubao, dan MiniMax.

        Penting

        Kemampuan model tingkat tinggi yang ditawarkan melalui layanan AI tidak disediakan langsung oleh Gerbang AI. Sebelum menggunakan layanan ini, Anda harus menilai kesesuaian dan keandalannya. Pastikan penggunaan layanan Anda mematuhi semua hukum, peraturan, dan perjanjian pengguna yang berlaku. Kami tidak bertanggung jawab atas konsekuensi apa pun yang timbul akibat ketidakpatuhan.

      • Service Address (base_url): Masukkan URL dasar layanan model tingkat tinggi. Formatnya adalah https://{domain}/v1.

        Untuk penyedia layanan Azure, alamat layanan adalah https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version={api-version}.

      • API-KEY: Masukkan kunci API yang diperlukan untuk mengakses layanan model tingkat tinggi. Jika Anda menggunakan Alibaba Cloud Model Studio, dapatkan kunci API dari halaman Kunci API Alibaba Cloud Model Studio. Untuk penyedia model tingkat tinggi lainnya, konsultasikan dengan penyedia layanan (SP) terkait.

    3. Setelah selesai mengonfigurasi, klik OK.

    Layanan Agen

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih Agent Service.

      • Service Name: Masukkan nama kustom untuk layanan tersebut.

      • Service Provider: Pilih Alibaba Cloud Model Studio, Dify, atau Custom.

        Penting

        Kemampuan agen yang ditawarkan melalui layanan Agen tidak disediakan langsung oleh Gerbang AI. Sebelum menggunakan layanan ini, Anda harus menilai kesesuaian dan keandalannya. Pastikan penggunaan layanan Anda mematuhi semua hukum, peraturan, dan perjanjian pengguna yang berlaku. Kami tidak bertanggung jawab atas konsekuensi apa pun yang timbul akibat ketidakpatuhan.

        Alibaba Cloud Model Studio

        Dify

        • API Address: Masukkan alamat titik akhir untuk layanan Agen. Nilai default-nya adalah https://api.dify.ai/v1.

        • Application Type: Pilih Agent atau Workflow.

          • Agent: Pilih opsi ini untuk tipe agen.

          • Workflow: Pilih opsi ini untuk tipe alur kerja.

        • API KEY: Dapatkan kunci dari penyedia layanan.

        Kustom

        • API Address: Masukkan titik akhir layanan Agen.

        • API KEY: Dapatkan kunci dari penyedia layanan.

    3. Setelah selesai mengonfigurasi, klik OK.

    Nama domain DNS

    Catatan

    Gerbang AI dapat menggunakan hasil penguraian DNS sebagai titik akhir layanan backend.

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih DNS Domain Name.

      • Service Name: Masukkan nama kustom untuk layanan tersebut.

      • Service Address: Masukkan alamat node backend layanan. Formatnya adalah <nama domain DNS>:<port layanan>. Anda dapat memasukkan beberapa alamat yang dipisahkan dengan koma (,).

        Penting

        Jika Anda menentukan alamat IP publik, Anda harus mengonfigurasi Gateway NAT.

      • TLS Mode: Default-nya dinonaktifkan.

        • Disabled: TLS tidak diperlukan untuk mengakses layanan.

        • One-way TLS: Aktifkan TLS satu arah saat Anda perlu mengakses layanan menggunakan HTTPS.

        • Two-way TLS (mTLS): Aktifkan mTLS saat Anda memerlukan otentikasi timbal balik.

    3. Setelah selesai mengonfigurasi, klik OK.

    Alamat tetap

    Catatan

    Jika layanan tidak menggunakan mekanisme penemuan layanan, Anda harus menambahkan alamat node backend secara manual.

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih Fixed Address.

      • Service Name: Masukkan nama kustom untuk layanan tersebut.

      • Service Address: Masukkan alamat node backend layanan. Formatnya adalah <IP>:<port layanan>. Anda dapat memasukkan beberapa alamat yang dipisahkan dengan koma (,).

        Penting

        Jika Anda menentukan alamat IP publik, Anda harus mengonfigurasi Gateway NAT.

      • TLS Mode: Default-nya dinonaktifkan.

        • Disabled: TLS tidak diperlukan untuk mengakses layanan.

        • One-way TLS: Aktifkan TLS satu arah saat Anda perlu mengakses layanan menggunakan HTTPS.

        • Two-way TLS (mTLS): Aktifkan mTLS saat Anda memerlukan otentikasi timbal balik.

    3. Setelah selesai mengonfigurasi, klik OK.

    Layanan kontainer

    Catatan

    Saat Anda menambahkan layanan kontainer sebagai sumber layanan, gerbang mengambil daftar layanan dari kluster ACK atau ACK Serverless yang ditentukan dan menambahkan layanan beserta alamat node backend-nya.

    1. Masuk ke Konsol Gerbang AI. Pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services.

    2. Buat sumber

      1. Klik tab Sources, lalu klik Create Source. Pada panel Create Source, konfigurasikan parameter berikut:

        • Source Type: Pilih Container Service untuk menemukan layanan backend menggunakan server Kubernetes.

        • ACK/ACS/ACK Serverless Cluster: Pilih kluster tempat layanan backend berada.

          Penting

          • Jika tidak ada kluster ACK, ACS, atau ACK Serverless di VPC saat ini, Anda harus terlebih dahulu membuat kluster ACK yang dikelola.

          • Untuk menambahkan sumber layanan dari VPC lain, Anda harus membuat instans gerbang di VPC tersebut sebelum dapat memilih kluster.

          • Satu instans gerbang dapat dikaitkan dengan maksimal tiga layanan kontainer ACK.

          • Gerbang AI hanya dapat menambahkan sumber Nacos atau ACK dari dalam VPC yang sama. Menambahkan sumber layanan lintas VPC tidak didukung.

      2. Setelah selesai mengonfigurasi, klik OK.

    3. Buat layanan

      1. Klik tab Services, lalu klik Create Service. Pada panel Create Service, konfigurasikan parameter berikut:

        • Service Source: Pilih Container Service.

          Gerbang mengambil daftar layanan dari kluster ACK atau kluster ACK Serverless yang ditentukan dan menambahkan layanan beserta alamat node backend-nya.

        • Namespace: Pilih namespace kluster. Secara default, layanan di namespace `arms-prom`, `kube-system`, dan `mse-pilot` disembunyikan.

        • Service List: Pilih layanan dari daftar. Secara default, layanan dengan nama yang diawali `consumers` disembunyikan.

      2. Setelah selesai mengonfigurasi, klik OK.

    Layanan Kubernetes SAE

    Penting

    Sebelum menambahkan layanan Kubernetes SAE sebagai sumber, Anda harus mengaktifkan registrasi dan penemuan layanan K8s untuk aplikasi SAE.

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih SAE Kubernetes Service. Aplikasi SAE harus memiliki akses layanan aplikasi yang dikonfigurasi berdasarkan ServiceName K8s.

      • Namespace: Pilih namespace kluster. Secara default, layanan di namespace `arms-prom`, `kube-system`, dan `mse-pilot` disembunyikan.

      • Service List: Pilih layanan dari daftar. Secara default, layanan dengan nama yang diawali consumers: disembunyikan.

    3. Setelah selesai mengonfigurasi, klik OK.

    Function Compute (FC)

    Penting

    Hanya Function Compute 3.0 yang didukung. Sumber layanan dari Function Compute 2.0 tidak didukung.

    1. Masuk ke Konsol Gerbang AI. Pada halaman daftar gerbang, pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services, lalu klik Create Service.

    2. Pada panel Create Service, konfigurasikan parameter berikut:

      • Service Source: Pilih Function Compute (FC).

      • Daftar Fungsi: Pilih fungsi dari daftar.

      • Versi atau Alias: Pilih versi atau alias fungsi.

    3. Setelah selesai mengonfigurasi, klik OK.

    MSE Nacos

    1. Masuk ke Konsol Gerbang AI. Pilih wilayah instans Anda dan klik ID instans. Di panel navigasi sebelah kiri, klik Services.

    2. Buat sumber

      1. Klik tab Sources, lalu klik Create Source. Pada panel Create Source, konfigurasikan parameter berikut:

        • Source Type: Pilih MSE Nacos untuk menemukan layanan backend menggunakan registrasi layanan MSE Nacos.

        • Nacos Cluster: Pilih kluster Nacos.

          Penting

          • Jika tidak ada kluster MSE Nacos di VPC saat ini, Anda harus terlebih dahulu membuat kluster MSE Nacos.

          • Untuk menambahkan sumber layanan dari VPC lain, Anda harus membuat instans gerbang di VPC tersebut sebelum dapat memilih kluster Nacos.

          • Daftar kluster hanya menampilkan instans MSE Nacos yang memiliki parameter MCPEnabled diatur ke `true`. Anda dapat mengubah pengaturan ini di konfigurasi parameter MSE Nacos.

          • Satu instans gerbang hanya dapat dikaitkan dengan satu instans Nacos.

      2. Setelah selesai mengonfigurasi, klik OK.

    3. Buat layanan

      1. Klik tab Services, lalu klik Create Service. Pada panel Create Service, konfigurasikan parameter berikut:

        • Service Source: Pilih MSE Nacos.

          Gerbang mengambil daftar layanan dari kluster Nacos yang ditentukan dan menambahkan layanan beserta alamat node backend-nya.

        • Namespace: Pilih namespace. Secara default, layanan di namespace arms-prom, kube-system, atau mse-pilot tidak ditampilkan.

        • Service List: Pilih layanan dari daftar. Secara default, layanan dengan nama yang diawali consumers: disembunyikan.

      2. Setelah selesai mengonfigurasi, klik OK.