Dokumentasi

API Reference

Panduan lengkap untuk integrasi jual-token API. Mulai dari autentikasi hingga generate gambar — semua dalam satu halaman.

Quickstart Autentikasi Chat Completions List Models Generate Gambar Transkripsi Audio Error Handling Rate Limit GitHub Copilot Cline Zoocode

Quickstart

Buat akun gratis, dapatkan API key dari dashboard, dan kirim request pertama kamu dalam hitungan menit.

Buat akun

Daftar di jualtoken.my.id/register

Ambil API key

Buka dashboard → klik tombol API key → salin.

Kirim request pertama

Request pertama

curl -X POST https://api.jual-token.ai/v1/chat \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.1-8b",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Autentikasi

Semua request ke API harus menyertakan API key di header Authorization. Key diawali dengan prefix sk-.

Header

Authorization: Bearer sk-your-api-key-here

⚠️ Jangan pernah expose API key di client-side code atau repository publik.

Gunakan environment variable atau server-side proxy.

POST/v1/chat/completions

Kirim prompt ke model dan dapatkan respons teks. Mendukung streaming, multi-turn conversation, dan function calling.

Request Body

Parameter	Tipe	Deskripsi
`model`wajib	`string`	ID model (lihat /v1/models)
`messages`wajib	`array`	Array pesan: [{role, content}]
`temperature`	`number`	0–2. Default: 1. Semakin tinggi semakin random.
`max_tokens`	`integer`	Maksimal token di respons.
`stream`	`boolean`	Set true untuk streaming (SSE).

Contoh Request

curl -X POST https://api.jual-token.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.1-8b",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Jelaskan quantum computing secara sederhana."}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

Response

200 OK

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "llama-3.1-8b",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing adalah jenis komputasi yang menggunakan fenomena mekanika kuantum..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 156,
    "total_tokens": 198
  }
}

GET/v1/models

Dapatkan daftar semua model yang tersedia. Filter berdasarkan provider atau kategori.

Contoh Request

curl https://api.jual-token.ai/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Response

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "llama-3.1-8b",
      "object": "model",
      "owned_by": "meta",
      "created": 1700000000
    },
    {
      "id": "mistral-7b",
      "object": "model",
      "owned_by": "mistral",
      "created": 1700000000
    }
  ]
}

POST/v1/images/generations

Hasilkan gambar dari teks menggunakan Stable Diffusion XL. Mengembalikan gambar base64 atau URL.

Parameter	Tipe	Deskripsi
`model`wajib	`string`	stable-diffusion-xl
`prompt`wajib	`string`	Deskripsi gambar yang diinginkan.
`size`	`string`	"1024x1024", "512x512", dll.
`n`	`integer`	Jumlah gambar. Default: 1.

Contoh Request

curl -X POST https://api.jual-token.ai/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "stable-diffusion-xl",
    "prompt": "A futuristic city at sunset, cyberpunk style",
    "size": "1024x1024"
  }'

POST/v1/audio/transcriptions

Transkripsi file audio ke teks menggunakan Whisper Large V3. Mendukung 99+ bahasa.

Parameter	Tipe	Deskripsi
`file`wajib	`binary`	File audio (mp3, wav, m4a, webm).
`model`wajib	`string`	whisper-large-v3
`language`	`string`	Kode bahasa ISO 639-1. Contoh: "id", "en".

Contoh Request

curl -X POST https://api.jual-token.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-your-api-key" \
  -F file="@audio.mp3" \
  -F model="whisper-large-v3" \
  -F language="id"

Error Handling

API mengembalikan HTTP status code standar. Semua error body mengikuti format yang konsisten:

Error Response

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Kamu telah melebihi limit token. Upgrade atau tunggu reset.",
    "status": 429
  }
}

Kode Error

Status	Kode	Penjelasan
`401`	`invalid_api_key`	API key tidak valid atau expired.
`403`	`insufficient_quota`	Token limit habis. Upgrade atau top up.
`404`	`model_not_found`	Model tidak ditemukan atau tidak tersedia.
`429`	`rate_limit_exceeded`	Terlalu banyak request. Tunggu sebentar.
`500`	`internal_error`	Kesalahan server. Coba lagi nanti.

Rate Limit

Setiap paket memiliki limit penggunaan. Limit di-reset setiap tanggal 1 setiap bulan.

Paket	Token / Bulan	Request / Menit	Harga
Free	50.000	60	Rp 0
Go	500.000	120	Rp 149.000/bln
Pro	5.000.000	300	Rp 499.000/bln

Response Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 2026-10-01T00:00:00Z

GitHub Copilot

Gunakan jual-token API sebagai backend untuk GitHub Copilot di VS Code. Cocok jika ingin pakai model alternatif dengan harga lebih murah.

Buka VS Code Settings (JSON)

Tekan Cmd+Shift+P → ketik "Open User Settings (JSON)"

Tambahkan konfigurasi berikut

settings.json

{
  "github.copilot.advanced": {
    "model": "llama-3.1-8b"
  },
  "github.copilot.chat.localeOverride": "id",
  "github.copilot.editor.enableAutoCompletions": true
}

⚠️ GitHub Copilot saat ini belum mendukung custom base URL secara native.

Untuk menggunakan jual-token API langsung, gunakan Cline atau Zoocode yang mendukung custom endpoint OpenAI-compatible.

Cline

Cline adalah AI coding assistant yang mendukung custom OpenAI-compatible API. Konfigurasikan jual-token sebagai provider untuk langsung generate, edit, dan debug code.

Install Cline extension

Buka Extensions di VS Code → cari "Cline" → Install.

Buka Cline Settings

Klik icon Cline di sidebar → pilih "OpenAI Compatible" sebagai provider.

Isi konfigurasi

Cline Settings

Base URL: https://api.jual-token.ai/v1
API Key:  sk-your-api-key
Model:    llama-3.1-8b

Parameter	Tipe	Deskripsi
`Base URL`wajib	`string`	https://api.jual-token.ai/v1
`API Key`wajib	`string`	Key dari dashboard, prefix sk-
`Model`wajib	`string`	llama-3.1-8b, mistral-7b, dll.

✓ Cline mendukung full agentic workflow — file edit, terminal commands, browser automation.

Zoocode

Zoocode adalah AI coding assistant yang mendukung custom OpenAI-compatible endpoints. Setup cepat, langsung bisa dipakai untuk coding dengan jual-token API.

Install Zoocode extension

Buka Extensions di VS Code → cari "Zoocode" → Install.

Buka Settings

Klik icon Zoocode di sidebar → buka Settings → pilih "Custom OpenAI".

Isi konfigurasi

Zoocode Settings

Base URL: https://api.jual-token.ai/v1
API Key:  sk-your-api-key
Model:    llama-3.1-8b

Parameter	Tipe	Deskripsi
`Base URL`wajib	`string`	https://api.jual-token.ai/v1
`API Key`wajib	`string`	Key dari dashboard, prefix sk-
`Model`wajib	`string`	llama-3.1-8b, mistral-7b, dll.

💡 Zoocode mendukung inline completions + chat. Keduanya bisa pakai jual-token API.

Siap untuk mulai?

Buat akun gratis dan mulai kirim request dalam hitungan menit.

Buat akun gratis Hubungi kami