Source: https://ailoot.ai/docs/id/integrations/mastra/
Canonical: https://ailoot.ai/docs/id/integrations/mastra/
Language: id

[SDK dan framework](https://ailoot.ai/docs/id/integrations/#sdk) 

# Mastra

[Markdown](https://ailoot.ai/docs/id/integrations/mastra/index.md)

Framework agen · OpenAI Chat, OpenAI Responses

| Format | Tempat mengatur |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Dalam Agent: model: { id: "\<provider\>/\<model\>", url: "\<alamat dasar\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/id/integrations/mastra/#setup)Konfigurasi

Salin konfigurasi dan ganti `sk-...` dengan kunci Anda dari dasbor Ailoot. Sebaiknya simpan kunci dalam variabel lingkungan `AILOOT_API_KEY`, jika aplikasi mendukungnya.

Sebelum menjalankan, panggil GET /v1/models dengan kunci Ailoot Anda. Pilih ID model yang tepat dengan metode POST /v1/chat/completions, POST /v1/responses, lalu gunakan ID tersebut dalam konfigurasi. Untuk agen, periksa juga dukungan alat dan fitur yang diperlukan versi klien Anda.

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Jawab dalam bahasa Rusia",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // hanya untuk model dengan metode responses
  }
});
```

Konfigurasi ini membaca kunci dari variabel `AILOOT_API_KEY`. Tetapkan sebelum menjalankan aplikasi:

```bash
export AILOOT_API_KEY="sk-..."   # tambahkan ke ~/.zshrc atau ~/.bashrc
```

```powershell
setx AILOOT_API_KEY "sk-..."   # lalu mulai ulang terminal
```

Contoh model: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Ambil model lain dari [katalog](https://ailoot.ai/models/id/) — pastikan format yang diperlukan tersedia.

## [](https://ailoot.ai/docs/id/integrations/mastra/#notes)Hal yang perlu diketahui

url berisi alamat dasar dengan /v1, bukan jalur lengkap ke /chat/completions. Secara default menggunakan Chat Completions; api: "responses" beralih ke Responses API. Bentuk id "provider/model" mengirim id model saja ke gateway. Kolom apiKey dalam objek model ditunjukkan dalam dokumentasi pada contoh dengan header; penggunaannya bersama url tidak dijelaskan secara terpisah.

## [](https://ailoot.ai/docs/id/integrations/mastra/#check)Pemeriksaan

- Untuk format OpenAI, alamatnya — `https://api.ailoot.ai/v1` (atau jalur lengkap jika aplikasi meminta alamat lengkap).
- Ajukan pertanyaan singkat. Jika terjadi kesalahan, lihat kode dan Request ID, lalu cocokkan dengan halaman [Kesalahan dan batas](https://ailoot.ai/docs/id/errors/).
- 404 segera setelah konfigurasi hampir selalu berarti alamat salah: ada tambahan atau kekurangan `/v1`.
- 402 — saldo tidak cukup untuk ditahan. Agen menahan saldo lebih besar daripada chat: [alasannya](https://ailoot.ai/docs/id/billing/reserve/).

Dokumentasi aplikasi: [https://mastra.ai/models](https://mastra.ai/models)

Masih ada pertanyaan? Kirim Request ID dan penjelasannya — kami akan membantu.[Hubungi dukungan](mailto:support@ailoot.ai)

## Ailoot · Perusahaan dan portofolio proyeknya





Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.





Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.





Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.