Cara Mengintegrasikan Gate.AI: Panduan Cepat untuk Pengembang

Gate.AI API Integrasi memungkinkan pengembang mengakses berbagai model AI melalui API yang kompatibel dengan OpenAI, menyediakan akses model yang terpusat, routing, dan pengujian tanpa perlu mengelola SDK secara terpisah dari setiap penyedia model. Baik untuk membangun chatbot, alat internal, agen cerdas, otomatisasi proses, maupun skrip evaluasi model, proses integrasi dapat disederhanakan secara signifikan. Panduan ini akan menjelaskan pembuatan kunci API, routing otomatis, pemilihan model manual, URL dasar yang kompatibel OpenAI, pengujian permintaan pertama, dan troubleshooting kesalahan konfigurasi umum, namun tidak mencakup topik tingkat tinggi seperti governance perusahaan, strategi penagihan, atau arsitektur keamanan kustom.

Prasyarat:

• Memiliki akun Gate.AI dan dapat mengakses Pengaturan Console.
• Lingkungan lokal telah dikonfigurasi dengan Python, Node.js, atau curl.

Apa saja kemampuan yang akan Anda miliki setelah menyelesaikan panduan ini?

Setelah menyelesaikan panduan ini, Anda akan mampu membuat kunci API Gate.AI, mengonfigurasi URL dasar yang kompatibel OpenAI, mengirim permintaan API pertama dengan model: "auto", dan menguji ID model tertentu.

Aplikasi apa saja yang dapat dibangun pengembang melalui integrasi API Gate.AI?

Pengembang dapat memanfaatkan API Gate.AI untuk mengakses sistem multi-model melalui format permintaan yang kompatibel OpenAI secara terpusat, dengan skenario aplikasi utama meliputi:

| Jenis Bangunan | Peran Gate.AI | Contoh Output | | ------------------ | ------------------------------------- | --------------------------------- | | Aplikasi Chat | Mengarahkan pesan pengguna ke model chat yang didukung | Asisten layanan pelanggan | | Alat Internal | Konfigurasi API terpadu antar tim | Asisten penulisan/penelitian AI | | Agen Cerdas & Otomatisasi | Menghubungkan panggilan model dan otomatisasi tugas | Asisten panggilan alat | | Pengujian Model | Membandingkan routing auto dan ID model tetap | Skrip evaluasi | | Migrasi Proyek | Mengganti URL dasar kompatibel OpenAI yang ada | Prototipe multi-model |

Jika Anda ingin agar Gate.AI secara otomatis memilih model, gunakan model: "auto"; jika ingin perilaku reproducible terhadap model tertentu, isi ID model spesifik.

Apa yang perlu Anda siapkan sebelum memulai?

Hanya dua kondisi utama yang perlu dipenuhi sebelum memulai:

| Kondisi Wajib | Alasan Penting | | ------------------ | ------------------------------------------------------------ | | Akses Akun Gate.AI | Perlu masuk ke Console untuk membuat kunci API dan memeriksa pengaturan routing | | Metode Permintaan Lokal | Perlu mengirim permintaan uji melalui Python, Node.js, atau curl |

Tidak perlu memilih semua model sekaligus di awal. Pastikan kunci API dan URL dasar dapat digunakan, lalu lakukan pengujian pemilihan model manual.

Langkah 1: Membuat Kunci API Gate.AI

Langkah ini akan membuat kredensial yang digunakan untuk otentikasi API Anda.

Langkah-langkah:

1. Kunjungi gate.ai.
2. Pilih metode login dan selesaikan otorisasi.
3. Buka Console → Pengaturan → API keys.
4. Klik Buat Kunci.
5. Salin kunci API segera dan simpan dengan aman.

Anda akan melihat kunci baru di area kunci API. Jika secret hanya muncul sekali, pastikan menyalin sebelum menutup jendela pembuatan.

Langkah 2: Pilih Routing Otomatis atau Pemilihan Model Manual

Langkah ini menentukan apakah Gate.AI akan secara otomatis memilih model, atau Anda menentukan model dalam permintaan.

Langkah-langkah:

1. Buka Console → Pengaturan → Routing.
2. Periksa saklar Otomatis Routing.
3. Jika ingin Gate.AI memilih model secara otomatis setiap kali permintaan, aktifkan routing otomatis.
4. Jika ingin menentukan ID model secara manual, matikan routing otomatis dan isi ID model dalam body permintaan.

| Mode Pilihan | Nilai Parameter Permintaan | Situasi Penggunaan | | ------------------ | ------------------------------------------- | ------------------------------------- | | Routing Otomatis | "model": "auto" | Saat membutuhkan routing otomatis Gate.AI | | Pemilihan Model Manual | "model": "anthropic/claude-sonnet-4.6" | Saat menguji atau menggunakan ID model tertentu |

Routing otomatis cocok untuk akses cepat dan pengujian routing umum; pemilihan manual cocok untuk pengujian reproducible terhadap satu model.

Langkah 3: Konfigurasi URL Dasar yang Kompatibel OpenAI

Langkah ini mengarahkan klien gaya OpenAI yang ada ke Gate.AI, bukan endpoint OpenAI default.

Gunakan URL dasar berikut:

text

Format otentikasi sebagai berikut:

text Authorization: Bearer YOUR_API_KEY

Dokumentasi Gate.AI mensyaratkan path API adalah /openai/v1, bukan hanya /v1 (per Juni 2026). Pastikan mengisi URL dasar lengkap sesuai contoh.

| Pengaturan | Nilai | | ------------------ | ---------------------------------------- | | URL Dasar | [diisi sesuai] | | Metode Otentikasi | Authorization: Bearer YOUR_API_KEY | | Format | Kompatibel OpenAI | | Endpoint Chat | POST /chat/completions | | Endpoint Model List| GET /models |

Kesalahan integrasi paling umum berasal dari URL dasar yang disingkat atau salinan kunci API yang salah. Pastikan kedua hal ini benar sebelum mengatur konfigurasi model.

Langkah 4: Kirim Permintaan API Pertama

Langkah ini untuk menguji apakah kunci API, URL dasar, dan format chat yang kompatibel OpenAI bekerja sama.

Contoh Python:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="auto", messages=[ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Say hello from Gate.AI."} ], )

print(completion.choices[0].message.content)

Contoh Node.js:

javascript import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "", });

const completion = await client.chat.completions.create({ model: "auto", messages: [ { role: "system", content: "You are a concise assistant." }, { role: "user", content: "Say hello from Gate.AI." } ], });

console.log(completion.choices[0].message.content);

Contoh curl:

bash curl /chat/completions
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{ "model": "auto", "messages": [ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Say hello from Gate.AI."} ] }'

Anda harus menerima balasan asisten yang normal. Jika terjadi kesalahan otentikasi, periksa kunci API terlebih dahulu, tidak perlu mengubah kode secara langsung.

Langkah 5: Uji ID Model Spesifik

Langkah ini memverifikasi bahwa pemilihan model manual berfungsi saat aplikasi membutuhkan model tertentu.

Ubah parameter model dari auto ke ID model yang didukung:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="anthropic/claude-sonnet-4.6", messages=[ {"role": "user", "content": "Explain model routing in one paragraph."} ], )

print(completion.choices[0].message.content)

Pastikan mengikuti nama model dari dokumentasi Gate.AI atau daftar model secara ketat. Salah eja akan menyebabkan permintaan gagal meskipun kunci API dan URL dasar benar.

Bagaimana mekanisme routing otomatis dalam permintaan API Gate.AI bekerja?

Routing otomatis Gate.AI mengandalkan pengisian model: "auto" dalam body permintaan, dan konfigurasi routing di console Gate.AI, untuk secara otomatis memilih model. Hingga Juni 2026, pengaturan routing terkait dapat dikelola di Console → Pengaturan → Routing.

| Metode Routing | Lokasi Pengaturan | Parameter API | | ------------------ | ---------------------------------------- | -------------------------------- | | Routing Otomatis | Console → Pengaturan → Routing | "model": "auto" | | Pemilihan Model Manual | Body Permintaan | Tentukan ID model | | Kontrol Strategi Routing | Pengaturan Routing di Console | Kustomisasi perilaku |

Routing otomatis tidak sama dengan menghilangkan field model. Anda harus secara eksplisit mengisi field model dan memberinya nilai auto agar Gate.AI melakukan routing otomatis.

Pilihan integrasi mana yang harus dipilih?

Sesuaikan metode integrasi dengan lingkungan aplikasi Anda:

| Metode | Situasi Penggunaan | Perubahan Utama | | ------------------------------ | ---------------------------------------- | ---------------------------------- | | SDK Python | Backend Python atau layanan yang sudah ada | Atur base_url dan api_key | | SDK Node.js | Layanan JavaScript atau TypeScript | Atur baseURL dan apiKey | | curl | Verifikasi cepat secara manual | Kirim header dan payload JSON langsung | | Aplikasi kompatibel OpenAI yang ada | Aplikasi sudah mendukung URL dasar kustom | Ganti URL dasar dan API key |

Sebagian besar pengembang disarankan untuk melakukan verifikasi cepat dengan curl, lalu mengintegrasikan dengan Python atau Node.js ke aplikasi nyata.

Apa saja penyebab umum kegagalan permintaan API Gate.AI?

Jika mengalami hambatan, lakukan troubleshooting satu per satu:

| Gejala | Penjelasan Penyebab | Solusi | | ---------------------------------------- | -------------------------------------------------- | --------------------------------------------------- | | 401 atau API key tidak valid | Kunci API hilang, kedaluwarsa, salah salin, atau tidak menggunakan Bearer | Buat/Salin ulang kunci, gunakan Authorization: Bearer YOUR_API_KEY | | Model tidak ditemukan | Menggunakan ID model yang salah atau tidak tersedia | Periksa dokumentasi model Gate.AI, atau uji routing "auto" | | Kode kompatibel OpenAI langsung error | URL dasar tidak lengkap atau hanya mengisi /v1 | Pastikan URL lengkap sesuai contoh | | Routing otomatis tidak berfungsi sesuai harapan | Routing otomatis dimatikan atau pengaturan tidak sesuai | Aktifkan Console → Pengaturan → Routing, periksa saklar otomatis | | Respon kosong atau error | Format body permintaan salah atau model tidak mendukung permintaan saat ini | Uji permintaan chat sederhana dulu, lalu tambahkan parameter secara bertahap |

Troubleshooting dimulai dari otentikasi, URL dasar, dan ID model. Sebagian besar masalah akses cepat dapat diselesaikan dengan tiga langkah ini.

Fitur konfigurasi lanjutan setelah permintaan pertama berhasil

Setelah permintaan pertama berhasil, pengembang dapat memperluas integrasi ke arah berikut:

• Mengonfigurasi perilaku routing model di console Gate.AI
• Melihat ketersediaan model dan memilih ID model tetap untuk pengujian produksi
• Membandingkan harga dan memilih model yang optimal untuk skenario dengan trafik tinggi

FAQ

Mengapa disarankan menggunakan model: "auto" terlebih dahulu?

Menggunakan model: "auto" memungkinkan verifikasi sekaligus terhadap kunci API, URL dasar, format permintaan, dan konfigurasi routing. Setelah dipastikan benar, baru uji ID model tertentu.

Bisakah menggunakan SDK OpenAI yang ada untuk panggil Gate.AI?

Bisa. Gate.AI mendukung format API kompatibel OpenAI, cukup atur API key Gate.AI dan ganti URL dasar dengan URL Gate.AI.

Mengapa permintaan gagal setelah beralih ke model tertentu?

ID model mungkin tidak ada, salah eja, atau akun tidak mendukung. Periksa ID model di dokumentasi Gate.AI dan coba lagi.

Apakah perlu mematikan routing otomatis saat menggunakan model tertentu?

Tidak selalu. Jika ingin memilih model secara manual, cukup kirim ID model dalam body permintaan. Jika perilaku tidak sesuai, periksa pengaturan routing di console.