Penyiapan Alat AI

Magpie

Siapkan Magpie sebagai pintu masuk model Felo API Platform agar gateway lokal melayaninya ke Codex, Claude Code, dan agen lain.

Gunakan panduan ini jika Anda memakai Magpie — aplikasi bilah menu dengan gateway lokal yang menyatukan model dari semua penyedia dalam satu daftar untuk agen coding — dan ingin menambahkan model dari Felo API Platform ke daftar tersebut. Magpie menjalankan gateway di 127.0.0.1:3425 dan menulis ulang konfigurasi setiap agen agar memanggilnya, jadi agen tidak pernah perlu tahu kunci maupun alamat Felo.

Sebelum memulai

Anda memerlukan satu kunci dari Felo API Platform. Kunci yang sama berlaku untuk protokol model, klien agen, serta API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page, dan SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Pasang Magpie jika belum:

curl -fsSL https://usemagpie.ai/install.sh | sh

Menambahkan Felo sebagai provider

Satu kunci Felo melayani Chat Completions, Responses, dan Anthropic Messages. Berikan semua alamat yang bisa dipakai Magpie:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

Di aplikasi, Providers → Add provider menerima data yang sama: nama felo, kuncinya, dan base kompatibel OpenAI https://openapi.felo.ai/api/v1. Untuk provider kompatibel Anthropic, gunakan https://openapi.felo.ai/api.

Begitu kunci disimpan, Magpie meminta daftar model dari Felo. Model tersebut muncul di pemilih setiap agen sebagai felo/<model-id>.

magpie provider models felo   # ambil ulang daftar Felo
magpie models                 # yang bisa dipilih agen, termasuk felo/<model>

Memilih model Felo di agen

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

Anda juga bisa memilih dari halaman Agents. Karena Felo menyediakan ketiga protokol, tiap agen tetap memakai protokolnya sendiri — Claude Code di Anthropic Messages, Codex di Responses — dan keduanya berujung ke Felo.

Kolom klien

Kolom	Nilai
Nama / id provider	`felo`
Base OpenAI Chat Completions	`https://openapi.felo.ai/api/v1`
Base OpenAI Responses	`https://openapi.felo.ai/api/v1`
Base Anthropic Messages	`https://openapi.felo.ai/api`
Kunci API	`FELO_API_KEY` Anda
Model	`felo/claude-sonnet-5-5`

Memverifikasi konfigurasi

magpie provider test felo

Magpie mengirim satu permintaan kecil per protokol dan melaporkan latensinya. Setelah itu ajukan pertanyaan singkat ke agen dengan model felo/ dipilih; jika ada jawaban, jalur agen → gateway Magpie → Felo sudah bekerja.

Pemecahan masalah

Masalah	Yang perlu diperiksa
Tidak ada model di bawah `felo`	Periksa kunci lalu jalankan `magpie provider models felo`
`Model not found`	Tulis `felo/<model-id>` persis seperti yang ditampilkan `magpie models`
Autentikasi gagal	Masukkan ulang kunci dengan `magpie provider key felo <key>`
Panggilan Anthropic gagal	Base harus `https://openapi.felo.ai/api`, tanpa `/v1`
Codex mengabaikan model	Mulai ulang Codex; ia membaca daftar model saat start