EN Buka Smooth di Telegram

DocsDeveloper API

Developer API

Model-model Smooth di balik satu API yang kompatibel OpenAI. Satu key, bayar Rupiah (QRIS) atau crypto, dan bisa dipakai dari SDK, tool apa pun, atau dari Smooth Agent.

Ambil key di console.smooth.family: masuk, buka API keys, buat satu, lalu isi saldo dengan QRIS atau crypto. Konsol menampilkan pemakaian per hari dan per model.

Model

ModelCocok untuk
smooth-flashCepat dan hemat: chat, ekstraksi, klasifikasi, tool call
smooth-proSerba bisa dan pintar: dokumen panjang, analisis, coding, agent
smooth-ultraPaling mampu: penalaran sulit dan tugas terberat

Harga per sejuta token tertera di konsol. Kamu hanya membayar yang dipakai, dari saldo prabayar.

Base URL

text
https://api.smooth.family/v1

API memakai format OpenAI Chat Completions, jadi SDK resmi OpenAI dan kebanyakan tool langsung jalan dengan mengganti base URL dan key. Streaming dan tool calling didukung.

Contoh

curl
curl https://api.smooth.family/v1/chat/completions \
  -H "Authorization: Bearer $SMOOTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "smooth-flash", "messages": [{"role": "user", "content": "Halo!"}]}'
Python (SDK openai)
from openai import OpenAI

client = OpenAI(base_url="https://api.smooth.family/v1", api_key="SMOOTH_API_KEY_KAMU")
reply = client.chat.completions.create(
    model="smooth-pro",
    messages=[{"role": "user", "content": "Ringkas ini jadi 3 poin: ..."}],
)
print(reply.choices[0].message.content)
Node.js (SDK openai)
import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.smooth.family/v1', apiKey: process.env.SMOOTH_API_KEY });
const stream = await client.chat.completions.create({
  model: 'smooth-flash',
  messages: [{ role: 'user', content: 'Tulis puisi pendek tentang hujan di Jakarta' }],
  stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content || '');

Pakai di Smooth Agent

config.toml
[providers.main]
provider = "smooth-router"
base_url = "https://api.smooth.family/v1"
model = "smooth-pro"
key_env = "SMOOTH_API_KEY"

Error dan batas

StatusArtinya
401API key tidak ada atau salah
402Saldo habis: isi di konsol
429Terlalu banyak permintaan untuk plan-mu: coba lagi sebentar
5xxGangguan sementara: coba lagi dengan jeda

Terakhir diperbarui: