SahabatMobile AI Documentation

SahabatMobile adalah AI Gateway Indonesia yang menyediakan akses ke 299+ model AI dunia melalui satu API endpoint yang kompatibel dengan format OpenAI. Tanpa kartu kredit, bayar pakai QRIS.

Quick Start

curl https://sahabatmobile.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-sm-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Authentication

Semua request harus menyertakan API key via Bearer token:

Authorization: Bearer sk-sm-xxxxxxxxxxxx

OpenCode Integration

OpenCode adalah AI coding assistant yang berjalan di terminal. SahabatMobile bisa digunakan sebagai provider dengan mengkonfigurasi opencode.json.

Step 1: Install OpenCode

# macOS / Linux
curl -fsSL https://opencode.ai/install | bash

# Atau pakai npm
npm install -g opencode-ai

Step 2: Buat API Key

Login ke Dashboard → API Keys, klik "Generate New Key". Copy key yang berawalan sk-sm-.

Step 3: Buat opencode.json (tanpa key — sama seperti provider lain)

Buat file opencode.json di root project kamu. Jangan taruh API key di sini — key dimasukkan nanti via /connect seperti provider OpenCode lainnya:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "sahabatmobile": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SahabatMobile",
      "options": {
        "baseURL": "https://sahabatmobile.com/api/v1"
      },
      "models": {
        "mimo-v2.5": {
          "name": "MiMo V2.5"
        },
        "MiniMax-M3": {
          "name": "MiniMax M3",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "google/gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 65536 }
        }
      }
    }
  }
}

Step 4: Connect — masukkan API key di sini (seperti provider lain)

/connect
# scroll ke bawah → Other
# Enter provider id: sahabatmobile
# Enter your API key: tempel sk-sm-... / sk-hemat-... kamu

/models
# pilih SahabatMobile → mimo-v2.5 (Paket Hemat) / MiniMax-M3 / dll.

Opsi lain: key via environment variable

Alternatif kalau tidak mau pakai /connect — ganti options dengan "apiKey": "{env:SAHABAT_API_KEY}", lalu:

export SAHABAT_API_KEY=sk-hemat-xxxx
opencode

Step 5: Jalankan OpenCode

# Buka terminal di folder project kamu
opencode

# Pilih model (ketik /models lalu pilih "SahabatMobile")
# Langsung mulai chat!

Cursor

Cursor mendukung endpoint OpenAI-compatible lewat pengaturan "Override OpenAI Base URL". Semua model SahabatMobile (termasuk MiniMax M3) bisa langsung dipakai di editor Cursor.

Step 1: Buka Settings → Models

Buka Settings (⌘+, / Ctrl+,) → cari Models → aktifkan Override OpenAI Base URL.

Step 2: Isi Base URL & API Key

OpenAI Base URL: https://sahabatmobile.com/api/v1
OpenAI API Key:  sk-sm-YOUR_KEY_HERE

Step 3: Tambah Model (contoh: MiniMax M3)

Di daftar model, klik Add model dan masukkan ID model, misalnya:

MiniMax-M3

ID lain yang bisa ditambahkan: google/gemini-2.5-flash, anthropic/claude-sonnet-4, qwen3.8-max, deepseek/deepseek-r1.

Claude Code

Claude Code secara native berbicara dengan Anthropic API. Karena SahabatMobile menyediakan endpoint OpenAI-compatible, cara paling andal adalah memakai OpenCode (sudah didukung penuh) atau menjembatani dengan bridge penghubung OpenAI↔Anthropic.

Opsi A: Pakai OpenCode untuk model Claude

Model Claude (mis. anthropic/claude-sonnet-4) sudah tersedia di gateway. Cukup ikuti panduan OpenCode dan pilih model Claude — pengalaman coding di terminal sama, tanpa setup tambahan.

Opsi B: Arahkan Claude Code ke SahabatMobile

Arahkan CLI claude langsung ke gateway SahabatMobile sebagai base URL-nya:

ANTHROPIC_BASE_URL=https://sahabatmobile.com/api/v1 \
ANTHROPIC_API_KEY=sk-sm-YOUR_KEY_HERE \
claude

VS Code

Di VS Code, pakai ekstensi Continue atau Cline yang mendukung provider OpenAI-compatible.

Continue

1. Install ekstensi Continue dari Marketplace.
2. Buka config (⚙️ → Config) dan tambahkan provider:

{
  "models": [{
    "title": "SahabatMobile MiniMax M3",
    "provider": "openai",
    "model": "MiniMax-M3",
    "apiBase": "https://sahabatmobile.com/api/v1",
    "apiKey": "sk-sm-YOUR_KEY_HERE"
  }]
}

Simpan, lalu pilih model "SahabatMobile MiniMax M3" dari sidebar Continue.

Cline

1. Install ekstensi Cline.
2. Di pengaturan Cline pilih provider OpenAI Compatible.
3. Isi:

   Base URL: https://sahabatmobile.com/api/v1
   API Key:   sk-sm-YOUR_KEY_HERE
   Model ID:  MiniMax-M3

Pakai API Langsung (tanpa Cursor / VS Code)

Kalau kamu belum punya Cursor atau editor apa pun, kamu tetap bisa pakai SahabatMobile lewat HTTP biasa. API-nya OpenAI-compatible, jadi cukup panggil endpoint https://sahabatmobile.com/api/v1/chat/completions dari cURL, Python, Node, Go, atau bahasa apa saja dengan header Authorization: Bearer.

Contoh cURL

curl https://sahabatmobile.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-sm-YOUR_KEY_HERE" \
  -d '{
    "model": "MiniMax-M3",
    "messages": [{"role":"user","content":"Halo SahabatMobile!"}],
    "stream": false
  }'

Contoh Python

from openai import OpenAI

client = OpenAI(
    base_url="https://sahabatmobile.com/api/v1",
    api_key="sk-sm-YOUR_KEY_HERE",
)

resp = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[{"role":"user","content":"Halo SahabatMobile!"}],
)
print(resp.choices[0].message.content)

Contoh Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://sahabatmobile.com/api/v1",
  apiKey: "sk-sm-YOUR_KEY_HERE",
});

const resp = await client.chat.completions.create({
  model: "MiniMax-M3",
  messages: [{ role: "user", content: "Halo SahabatMobile!" }],
});
console.log(resp.choices[0].message.content);

Hermes Agent NEWBIE FRIENDLY

Hermes Agent adalah AI agent yang bisa kamu arahkan ke SahabatMobile lewat endpoint OpenAI-compatible. Tidak perlu kartu kredit, cukup pakai QRIS. Panduan ini dari NOL sampai sukses — khusus untuk Paket Hemat → MiMo V2.5 (paket paling murah, 1M konteks, hanya Mimo Original).

Tour akan menyorot tiap langkah & scroll otomatis — cocok untuk yang baru pertama kali pakai.

Langkah 1 — Daftar / Login

Langkah 2 — Beli Paket Hemat (khusus MiMo 2.5)

Langkah 3 — Ambil API Key Paket (di Plan Details yang benar)

Langkah 4 — Pasang di Hermes Agent

Hermes yang support OpenAI-compatible cukup diisi 3 kolom ini:

Base URL: https://sahabatmobile.com/api/v1
API Key:  sk-sm-DARI_PLAN_DETAILS (tempel key paket, bukan key PAYG lama)
Model:    mimo-v2.5

Langkah 5 — Tes Koneksi (wajib sebelum pakai serius)

Opsi A — lewat Hermes langsung: kirim pesan halo. Jika dibalas, sukses.

Opsi B — tes pakai curl (paling akurat untuk newbie yang mau pastikan key benar):

curl https://sahabatmobile.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-sm-YOUR_PAKET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.5",
    "messages": [{"role": "user", "content": "halo, tes koneksi mimo 2.5 via sahabatmobile"}]
  }'

Opsi C — Python:

from openai import OpenAI
client = OpenAI(api_key="sk-sm-YOUR_PAKET_KEY", base_url="https://sahabatmobile.com/api/v1")
r = client.chat.completions.create(model="mimo-v2.5", messages=[{"role":"user","content":"halo"}])
print(r.choices[0].message.content)

Jika sukses → credit di Plan Details akan berkurang sedikit (tanda pemakaian tercatat).

Langkah 6 — Pantau Kuota & Isi Ulang

Kembali ke Plan Details — ada bar progress credit terpakai / total + % 5 jam & mingguan. Jika habis, top-up / perpanjang paket di Packages. Tidak perlu ganti API key — key paket tetap sama selama paket aktif.

Troubleshooting Newbie (paling sering)

Berlangganan Paket & API Key Paket

Selain API key pay-as-you-go (bayar per-credit), SahabatMobile juga menyediakan paket bulanan (mis. MiniMax HEMAT) dengan credit dan model tertentu sudah termasuk. Ada dua jenis API key yang berbeda:

Cara Berlangganan (QRIS)

Menggunakan API Key Paket di Tools

Cara pakainya persis sama dengan key pay-as-you-go — cukup gunakan key paket sebagai Bearer token dan base URL https://sahabatmobile.com/api/v1 di OpenCode, Cursor, VS Code, atau kode Python/Node.js (lihat section integrasi di atas).

Manual Setup (Non-OpenCode)

Gunakan endpoint ini di tools/framework apapun yang support OpenAI-compatible API:

# Base URL
https://sahabatmobile.com/api/v1

# Headers
Authorization: Bearer sk-sm-YOUR_KEY_HERE
Content-Type: application/json

# Chat Completions
POST https://sahabatmobile.com/api/v1/chat/completions

# List Models
GET https://sahabatmobile.com/api/v1/models

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-sm-YOUR_KEY_HERE",
    base_url="https://sahabatmobile.com/api/v1"
)

response = client.chat.completions.create(
    model="google/gemini-2.5-flash",
    messages=[{"role": "user", "content": "Halo!"}]
)
print(response.choices[0].message.content)

Node.js (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'sk-sm-YOUR_KEY_HERE',
    baseURL: 'https://sahabatmobile.com/api/v1'
});

const response = await client.chat.completions.create({
    model: 'google/gemini-2.5-flash',
    messages: [{ role: 'user', content: 'Halo!' }]
});
console.log(response.choices[0].message.content);

API Reference

POST /v1/chat/completions

Membuat chat completion. Sama persis dengan OpenAI API format.

{
    "model": "google/gemini-2.5-flash",
    "messages": [
        {"role": "system", "content": "Kamu adalah asisten AI."},
        {"role": "user", "content": "Jelaskan tentang React"}
    ],
    "temperature": 0.7,
    "max_tokens": 4096
}

GET /v1/models

Menampilkan semua model yang tersedia.

curl https://sahabatmobile.com/api/v1/models \
  -H "Authorization: Bearer sk-sm-YOUR_KEY_HERE"

Response Format

{
    "id": "chatcmpl-xxx",
    "object": "chat.completion",
    "model": "google/gemini-2.5-flash",
    "choices": [{
        "index": 0,
        "message": {
            "role": "assistant",
            "content": "Halo! Ada yang bisa saya bantu?"
        },
        "finish_reason": "stop"
    }],
    "usage": {
        "prompt_tokens": 10,
        "completion_tokens": 15,
        "total_tokens": 25
    }
}

Available Models

299 model dari 5 provider:

💡 Klik nama provider untuk filter, lalu klik salah satu baris model untuk melihat cara pakainya di OpenCode / VS Code / Cursor / API.

{
  "models": [{
    "title": "SahabatMobile ",
    "provider": "openai",
    "model": "",
    "apiBase": "https://sahabatmobile.com/api/v1",
    "apiKey": "sk-sm-YOUR_KEY_HERE"
  }]
}

OpenAI Base URL: https://sahabatmobile.com/api/v1
OpenAI API Key:  sk-sm-YOUR_KEY_HERE
Model:  (klik Add model, tempel ID ini)

curl https://sahabatmobile.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-sm-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"model": "", "messages": [{"role": "user", "content": "Halo!"}]}'

from openai import OpenAI
client = OpenAI(base_url="https://sahabatmobile.com/api/v1", api_key="sk-sm-YOUR_KEY_HERE")
r = client.chat.completions.create(model="", messages=[{"role": "user", "content": "Halo!"}])
print(r.choices[0].message.content)

Harga & Credit

Penggunaan dihitung dari jumlah token (input + output) yang dikonversi ke credit. Top-up dan paket tersedia langsung dari Dashboard.

Detail paket dan penawaran khusus (termasuk akses penuh MiniMax) dapat dilihat di Dashboard → Packages. API key pay-as-you-go dibuat di Dashboard → API Keys.

MiniMax HEMAT — Panduan Lengkap

Paket MiniMax HEMAT memberikan akses ke 8 model MiniMax dengan harga hemat. Cocok untuk heavy users yang sering menggunakan AI untuk coding, writing, atau analysis.

Model Yang Tersedia

Cara Aktifkan Paket

Konfigurasi OpenCode untuk MiniMax

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "sahabatmobile": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SahabatMobile",
      "options": {
        "baseURL": "https://sahabatmobile.com/api/v1",
        "apiKey": "sk-minimax-YOUR_PACKAGE_KEY_HERE",
        "headers": {
          "x-api-key": "sk-minimax-YOUR_PACKAGE_KEY_HERE"
        }
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax M3 (Hemat)",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "MiniMax-M2.7": {
          "name": "MiniMax M2.7 (Hemat)",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "MiniMax-M2.5": {
          "name": "MiniMax M2.5 (Hemat)",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "MiniMax-M2.1": {
          "name": "MiniMax M2.1 (Hemat)",
          "limit": { "context": 1000000, "output": 65536 }
        },
        "MiniMax-M2": {
          "name": "MiniMax M2 (Hemat)",
          "limit": { "context": 1000000, "output": 65536 }
        }
      }
    }
  }
}

# Buka terminal di folder project
opencode

# Pilih model
# Ketik /models → pilih "SahabatMobile" → pilih model MiniMax

Contoh Penggunaan

# Chat dengan MiniMax M3
curl https://sahabatmobile.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-minimax-YOUR_PACKAGE_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3",
    "messages": [{"role": "user", "content": "Jelaskan tentang React hooks"}]
  }'

Credit Usage

Limit & Quota

Troubleshooting MiniMax

Error "Quota exceeded" — Credits habis. Top-up di Dashboard → Wallet.

Error "Rate limited" — Terlalu banyak request. Tunggu 1 menit.

Error "Model not found" — Pastikan paket MiniMax HEMAT aktif di Dashboard → Packages.

Slow response — Gunakan model highspeed (M2.7-highspeed) atau coba lagi nanti.

Limits & Quotas

Troubleshooting

OpenCode: "Missing API key"

Pastikan opencode.json memiliki apiKey dan headers.x-api-key yang diisi. Restart OpenCode setelah edit config.

OpenCode: "Unprocessable Content"

Pastikan API key kamu valid dan paket masih aktif. Cek di Dashboard → Plan Details.

401 Unauthorized

API key tidak valid atau expired. Buat key baru di /ai/api-keys.

429 Too Many Requests

Rate limit terlampaui. Tunggu beberapa saat atau gunakan API key lain.

500 Internal Server Error

Server sedang down. Credits akan otomatis dikembalikan jika request gagal.

Model Tidak Ditemukan

Pastikan model ID benar (case-sensitive). Lihat daftar lengkap di Models.

FAQ

Apakah bisa gratis?

Ya, beberapa model tersedia gratis. Daftar dan langsung gunakan tanpa top-up.

Metode pembayaran apa yang didukung?

QRIS, bank transfer, e-wallet (GoPay, OVO, DANA, ShopeePay), dan credit card.

Bisakah digunakan untuk production?

Bisa. API kami dirancang untuk production use dengan SLA dan auto-scaling.

Dimana saya bisa dapat bantuan?

Email: support@sahabatmobile.com
WhatsApp: +62 813-3870-009