Dokumentasi

Panduan Lengkap YupiAI Gateway

Pelajari Quick Setup atau ikuti panduan manual untuk aplikasi pilihan Anda. Konfigurasi pada halaman ini terakhir diperiksa pada 15 Agustus 2026.

01. Pengenalan

Dasar API YupiAI

YupiAI menyediakan satu gateway untuk aplikasi yang memakai API OpenAI, OpenAI Responses, atau Anthropic Messages. Gunakan alamat endpoint yang sesuai dengan aplikasi.

Key lama tetap berlaku

API key baru diawali yupi_ai_. Key lama yang diawali rk_live_ tetap bekerja seperti biasa di semua endpoint — tidak perlu diganti dan tidak perlu mengubah konfigurasi aplikasi Anda.

Endpoint Anthropic tidak memakai /v1

Claude Code menambahkan path /v1/messages secara otomatis. Isi ANTHROPIC_BASE_URL dengan https://gateway.euphy.cloud.

Uji API sebelum membuka aplikasi

Jalankan request berikut untuk memeriksa API key, saldo, endpoint, dan Model ID.

Terminal — OpenAI Chat Completions
curl https://gateway.euphy.cloud/v1/chat/completions \
  -H "Authorization: Bearer yupi_ai_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "yupiai-glm5.2",
    "messages": [{ "role": "user", "content": "Balas: koneksi berhasil" }]
  }'

02. Quick Setup

Tutorial Quick Setup

Installer memandu Anda melalui pengaturan di terminal. Setiap perubahan tetap memerlukan pilihan atau persetujuan Anda.

macOS atau Linux

Terminal
curl -fsSL https://gateway.euphy.cloud/install.sh | bash

Windows

PowerShell
irm https://gateway.euphy.cloud/install.ps1 | iex
01

Tempel API key lengkap

Salin key yang diawali yupi_ai_ dari Dashboard. Input disembunyikan saat diketik.
02

Pilih model utama

Gunakan tombol panah, lalu tekan Enter. Model ini menjadi pilihan awal dan dapat diganti nanti.
03

Pilih aplikasi

Ikuti pilihan yang ditampilkan oleh installer. Tekan Space untuk memilih dan Enter untuk melanjutkan.
04

Baca ringkasan hasil

Periksa status setiap langkah. Setelah selesai, buka ulang aplikasi agar konfigurasi dimuat.

Ingin meninjau skrip sebelum menjalankannya?

Unduh skrip, baca isinya dengan editor teks, lalu jalankan file lokal.
macOS / Linux — mode tinjau
curl -fsSL https://gateway.euphy.cloud/install.sh -o /tmp/yupiai-install.sh
less /tmp/yupiai-install.sh
bash /tmp/yupiai-install.sh
Windows — mode tinjau
Invoke-WebRequest https://gateway.euphy.cloud/install.ps1 -OutFile "$env:TEMP\yupiai-install.ps1"
notepad "$env:TEMP\yupiai-install.ps1"
& "$env:TEMP\yupiai-install.ps1"

Uninstall dan reset

Jalankan ini kalau ingin melepas YupiAI dari aplikasi Anda, atau ingin mulai bersih sebelum setup ulang — misalnya setelah ganti API key. Installer tidak mencatat apa pun di file terpisah, jadi uninstaller-lah yang mengembalikan setiap konfigurasi ke keadaan semula.

Terminal
curl -fsSL https://gateway.euphy.cloud/uninstall.sh | bash
PowerShell
irm https://gateway.euphy.cloud/uninstall.ps1 | iex
01

Pilih tingkat pembersihan

Hapus konfigurasi membuang entri YupiAI dan menyimpan semua backup lama. Reset total juga menghapus file .bak-* lama sehingga instalasi berikutnya benar-benar mulai dari nol.
02

Pilih aplikasi

Aplikasi yang masih menyimpan konfigurasi YupiAI sudah tercentang otomatis. Space untuk mengubah pilihan, Enter untuk melanjutkan.
03

Konfirmasi

Layar terakhir menampilkan target dan tingkat pembersihannya sebelum ada satu file pun yang diubah.
04

Buka terminal baru

Variabel environment lama baru hilang di sesi terminal berikutnya. Restart juga aplikasi yang sedang berjalan.

Aplikasi Anda tidak ikut dihapus

Yang dibuang hanya entri YupiAI di dalam konfigurasi tiap aplikasi, ditambah variabel environment yang ditulis installer. Claude Code, Codex, Continue, dan lainnya tetap terpasang beserta pengaturan Anda sendiri.

Setiap perubahan bisa dibatalkan

Sebelum menulis, uninstaller menyalin file lama ke <file>.bak-YYYYmmdd-HHMMSS di folder yang sama. Ingin memulihkan? Salin kembali file itu ke nama aslinya.

Untuk melihat apa saja yang akan dihapus tanpa mengubah apa pun, jalankan dengan mode dry-run:

macOS / Linux — dry-run
curl -fsSL https://gateway.euphy.cloud/uninstall.sh -o /tmp/yupiai-uninstall.sh
bash /tmp/yupiai-uninstall.sh --all --dry-run
Windows — dry-run
Invoke-WebRequest https://gateway.euphy.cloud/uninstall.ps1 -OutFile "$env:TEMP\yupiai-uninstall.ps1"
& "$env:TEMP\yupiai-uninstall.ps1" -All -DryRun

03. Model

Model dan Model ID

Katalog lengkap beserta tarif tiap model tinggal di halaman tersendiri, satu lembar data per model. Salin Model ID dari sana persis seperti yang ditampilkan.

Katalog memuat tarif terdaftar per kelas token, tarif efektif untuk beban kerja yang Anda pilih, batas akses per paket, dan potongan konfigurasi siap tempel untuk tiap aplikasi.

Buka katalog model

04. Kredit

Kredit dan multiplier

YupiAI menghitung pemakaian berdasarkan token, bukan jumlah request. Token input baru, input yang dilaporkan sebagai cache hit oleh upstream, dan token output dapat memiliki multiplier berbeda untuk setiap model.

Rumus
kredit = (token_input_baru × multiplier_input)
       + (token_input_cache × multiplier_cache)
       + (token_output × multiplier_output)

Model paling ekonomis saat ini adalah yupiai-glm5.2. Model kelas atas yang tersedia adalah yupiai-glm5.2. Tarif tiap kelas token untuk setiap model ada di lembar datanya masing-masing.

Cache hanya dihitung saat benar-benar dilaporkan

Tarif cache diterapkan pada token yang ditandai cached oleh respons upstream. Jangan mengasumsikan setiap prompt berulang otomatis menjadi cache hit; hasilnya bergantung pada model, provider, dan pola prompt.

05. Integrasi

Codex & Claude Code

Codex memakai Responses API, sedangkan Claude Code memakai Anthropic Messages. Ikuti konfigurasi yang sesuai.

Codex CLI, IDE extension, dan desktop

Daftarkan YupiAI di config.toml, lalu simpan API key sebagai environment variable.

Referensi: Referensi konfigurasi Codex

Edit file ~/.codex/config.toml pada macOS/Linux atau %USERPROFILE%\.codex\config.toml pada Windows.

config.toml
model = "yupiai-glm5.2"
model_provider = "yupiai"

[model_providers.yupiai]
name = "YupiAI Gateway"
base_url = "https://gateway.euphy.cloud/v1"
env_key = "YUPIAI_API_KEY"
env_key_instructions = "Masukkan API key YupiAI yang diawali yupi_ai_"
requires_openai_auth = false
supports_websockets = false
wire_api = "responses"
macOS / Linux
export YUPIAI_API_KEY="yupi_ai_xxxxxxxxxxxxxxxx"
codex
Windows PowerShell
[Environment]::SetEnvironmentVariable("YUPIAI_API_KEY", "yupi_ai_xxxxxxxxxxxxxxxx", "User")
# Tutup dan buka kembali terminal, lalu jalankan:
codex

Claude Code CLI & extension

Arahkan Anthropic Messages ke host gateway YupiAI.

Referensi: Panduan LLM gateway Claude Code

Edit ~/.claude/settings.json dan gabungkan nilai berikut ke object yang sudah ada.

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gateway.euphy.cloud",
    "ANTHROPIC_AUTH_TOKEN": "yupi_ai_xxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "yupiai-glm5.2",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "yupiai-glm5.2",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "YupiAI yupiai-glm5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "yupiai-glm5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "yupiai-glm5.2",
    "ENABLE_TOOL_SEARCH": "false"
  }
}

Jangan gunakan format OpenAI di Claude Code

Claude Code membutuhkan endpoint Anthropic Messages. Base URL adalah host gateway tanpa /v1; token dikirim sebagai Bearer melalui ANTHROPIC_AUTH_TOKEN.

06. Integrasi

Cline, Roo Code & Kilo Code

Ketiga aplikasi mendukung provider OpenAI-compatible. Gunakan Base URL yang berakhir dengan /v1 dan Model ID dari katalog model.

Cline

Pilih OpenAI Compatible dari halaman provider, lalu verifikasi koneksi.

Referensi: Panduan OpenAI Compatible Cline

Buka Cline → Settings → API Provider. Isi nilai di atas, biarkan Azure Identity nonaktif, lalu klik Verify.

Roo Code

Buat API Configuration Profile dengan provider OpenAI Compatible.

Referensi: Panduan OpenAI Compatible Roo Code

01

Buka pengaturan provider

Di panel Roo Code, buka Settings lalu API Configuration Profile.
02

Pilih OpenAI Compatible

Isi Base URL https://gateway.euphy.cloud/v1 dan API key YupiAI.
03

Masukkan Model ID

Gunakan yupiai-glm5.2, simpan, lalu aktifkan profile.

Tool calling wajib

Roo Code hanya memakai native tool calling. Jika sebuah model tidak stabil saat menjalankan tool, ganti ke model YupiAI lain yang memang ditujukan untuk coding agent.

Kilo Code CLI

Daftarkan provider custom di konfigurasi global yang dipercaya, bukan di file proyek.

Referensi: Dokumentasi konfigurasi Kilo CLI

Edit ~/.config/kilo/kilo.jsonc. Referensi environment variable hanya diproses dari konfigurasi global yang dipercaya.

kilo.jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "yupiai/yupiai-glm5.2",
  "provider": {
    "yupiai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "YupiAI Gateway",
      "options": {
        "apiKey": "{env:YUPIAI_API_KEY}",
        "baseURL": "https://gateway.euphy.cloud/v1"
      },
      "models": {
        "yupiai-glm5.2": {
          "name": "YupiAI yupiai-glm5.2",
          "tool_call": true
        }
      }
    }
  }
}

07. Integrasi

Agent lokal

Gunakan format konfigurasi resmi setiap aplikasi. Mulai dari satu model, lalu uji koneksi sebelum menambahkan model lain.

Continue

Tambahkan model provider OpenAI ke config.yaml schema v1.

Referensi: Referensi config.yaml Continue

~/.continue/config.yaml
name: YupiAI
version: 1.0.0
schema: v1
models:
  - name: YupiAI yupiai-glm5.2
    provider: openai
    model: yupiai-glm5.2
    apiBase: https://gateway.euphy.cloud/v1
    apiKey: yupi_ai_xxxxxxxxxxxxxxxx
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use

Simpan file, lalu gunakan pemilih model Continue untuk memilih nama YupiAI yang baru ditambahkan.

OpenClaw

Tambahkan provider melalui models.providers, lalu pilih model dengan format provider/model.

Referensi: Referensi model provider OpenClaw

Simpan API key ke environment variable, lalu gabungkan blok berikut ke ~/.openclaw/openclaw.json.

openclaw.json (JSON5)
{
  models: {
    mode: "merge",
    providers: {
      yupiai: {
        baseUrl: "https://gateway.euphy.cloud/v1",
        apiKey: "${YUPIAI_API_KEY}",
        api: "openai-completions",
        models: [{ id: "yupiai-glm5.2", name: "YupiAI yupiai-glm5.2" }]
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "yupiai/yupiai-glm5.2" },
      models: { "yupiai/yupiai-glm5.2": {} }
    }
  }
}
Validasi
openclaw config validate
openclaw models set yupiai/yupiai-glm5.2
openclaw models list

Hermes Agent

Gunakan provider custom OpenAI-compatible.

Referensi: Dokumentasi provider Hermes Agent

Cara paling aman adalah menjalankan hermes model, pilih Custom Endpoint, lalu isi Base URL, key, dan model. Konfigurasi file ekuivalennya:

~/.hermes/config.yaml
model:
  default: "yupiai-glm5.2"
  provider: "custom"
  base_url: "https://gateway.euphy.cloud/v1"
  api_key: "yupi_ai_xxxxxxxxxxxxxxxx"

Batas context Hermes

Hermes saat ini mensyaratkan model dengan context window minimal 64K untuk alur agent. Pilih model YupiAI yang memenuhi kebutuhan tersebut.

Goose

Buat custom provider. Nilai base_url harus berupa endpoint chat/completions lengkap.

Referensi: Panduan custom provider Goose

Buat file yupiai.json di folder ~/.config/goose/custom_providers/. Di Windows gunakan %APPDATA%\Block\goose\config\custom_providers\.

yupiai.json
{
  "name": "yupiai",
  "engine": "openai",
  "display_name": "YupiAI Gateway",
  "description": "YupiAI OpenAI-compatible gateway",
  "api_key_env": "YUPIAI_API_KEY",
  "base_url": "https://gateway.euphy.cloud/v1/chat/completions",
  "models": [{ "name": "yupiai-glm5.2" }],
  "supports_streaming": true,
  "requires_auth": true
}
Jalankan
export YUPIAI_API_KEY="yupi_ai_xxxxxxxxxxxxxxxx"
goose session start --provider yupiai

OpenHands

Isi provider, model, API key, dan Base URL melalui Settings.

Referensi: Dokumentasi LLM OpenHands

Buka Settings → LLM. Isi provider, model, dan key; buka Advanced untuk Base URL. OpenHands menggunakan LiteLLM, sehingga prefix openai/ pada model diperlukan untuk endpoint OpenAI-compatible.

08. Integrasi

Aplikasi chat

LibreChat dan Chatbox mendukung endpoint OpenAI-compatible. Perhatikan perbedaan antara API Host dan API Path.

LibreChat

Daftarkan YupiAI sebagai custom endpoint di librechat.yaml.

Referensi: Referensi custom endpoint LibreChat

.env
YUPIAI_API_KEY=yupi_ai_xxxxxxxxxxxxxxxx
librechat.yaml
version: 1.3.5
cache: true
endpoints:
  custom:
    - name: "YupiAI"
      apiKey: "${YUPIAI_API_KEY}"
      baseURL: "https://gateway.euphy.cloud/v1"
      models:
        default: ["yupiai-glm5.2"]
        fetch: true
      titleConvo: true
      titleModel: "yupiai-glm5.2"
      modelDisplayLabel: "YupiAI"

Untuk Docker, mount librechat.yaml ke container API, lalu restart LibreChat. Opsi fetch: true mengambil katalog model dari YupiAI.

Chatbox

Isi API Host dan API Path secara terpisah agar /v1 tidak ditulis dua kali.

Referensi: Panduan provider Chatbox

Buka Settings → Model Provider → Add. Setelah menyimpan provider dan model, klik Check untuk menguji koneksi.

09. Catatan

Status kompatibilitas Cursor

Panduan lama yang memakai Override OpenAI Base URL dan Model ID kustom tidak lagi menjadi jalur utama.

Pilih integrasi yang didokumentasikan

Dokumentasi Cursor saat ini menjelaskan BYOK untuk provider yang mereka dukung, tetapi tidak menjamin gateway OpenAI-compatible dengan Model ID YupiAI. Gunakan Cline, Roo Code, atau Codex untuk konfigurasi yang lebih konsisten.

Jika Cursor masih menampilkan Override OpenAI Base URL, Anda dapat mencoba https://gateway.euphy.cloud/v1. Konfigurasi ini bersifat eksperimental dan tidak berlaku untuk Tab Completion.

Referensi: Dokumentasi API Keys Cursor

10. Kebijakan

Masa aktif dan saldo

Pembelian baru menambah kredit dan masa aktif yang tersisa. Saat masa aktif berakhir, sisa kredit kedaluwarsa dan API berhenti tanpa membuat tagihan lanjutan.

Contoh auto-stack

AksiKreditHari
Beli Starter+1.000.000+30
Beli Pro+2.500.000+30
Total sebelum dipakai3.500.00060

Pengeluaran tetap terkendali

Ketika kredit atau masa aktif habis, request ditolak. Tidak ada auto-debit atau saldo negatif. Top-up kembali untuk melanjutkan penggunaan.

Masih bingung integrasi?

Gunakan Quick Setup atau pilih panduan manual sesuai aplikasi Anda.