Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Gambaran Umum

TokenLab adalah native-first dan kompatibel dengan OpenAI. Gunakan rute native penyedia seperti POST /v1/messages untuk Anthropic dan /v1beta/models/...:generateContent untuk Gemini ketika Anda memerlukan perilaku native, dan gunakan endpoint /v1 yang kompatibel dengan OpenAI ketika Anda memigrasikan SDK atau alat bergaya OpenAI yang sudah ada. POST /v1/responses tetap menjadi jalur opsional tingkat lanjut untuk perilaku khusus Responses.

​
Base URL

https://api.tokenlab.sh

​
Autentikasi

Semua endpoint API memerlukan autentikasi menggunakan Bearer token: 
Authorization: Bearer sk-your-api-key
Dapatkan API key Anda dari Dashboard.
Tentang Interactive Playground: Playground di situs dokumentasi ini hanya untuk tujuan demonstrasi dan tidak mendukung penginputan API key. Untuk menguji API, silakan gunakan:
  • cURL - Salin contoh perintah dan ganti sk-your-api-key dengan key asli Anda
  • Postman - Impor OpenAPI spec kami
  • SDK - Gunakan OpenAI/Anthropic SDK dengan base URL kami

​
Endpoint yang Didukung

​
Chat & Pembuatan Teks

EndpointMetodeDeskripsi
/v1/chat/completionsPOSTChat completions yang kompatibel dengan OpenAI
/v1/messagesPOSTMessages API yang kompatibel dengan Anthropic
/v1/responsesPOSTOpenAI Responses API

​
Embeddings & Rerank

EndpointMetodeDeskripsi
/v1/embeddingsPOSTBuat text embeddings
/v1/rerankPOSTRerank dokumen

​
Gambar

EndpointMetodeDeskripsi
/v1/images/generationsPOSTHasilkan gambar dari teks
/v1/images/editsPOSTEdit gambar
/v1/images/generations/{id}GETPath status tugas gambar untuk respons gambar berbasis tugas
Beberapa model gambar mungkin mengembalikan hasil secara inline, beberapa mungkin mengembalikan respons berbasis tugas, dan beberapa mungkin berperilaku keduanya tergantung pada jalur provider yang diarahkan. Jika respons pembuatan menyertakan poll_url, ikuti URL tersebut sepenuhnya.

​
Audio

EndpointMetodeDeskripsi
/v1/audio/speechPOSTTeks-ke-suara (TTS)
/v1/audio/transcriptionsPOSTSuara-ke-teks (STT)

​
Video

EndpointMetodeDeskripsi
/v1/videos/generationsPOSTBuat tugas pembuatan video
/v1/tasks/{id}GETDapatkan status tugas asinkron untuk pekerjaan video
/v1/videos/generations/{id}GETPath status tugas video yang kompatibel dengan versi lama (legacy)
Untuk klien baru, lebih disarankan menggunakan /v1/tasks/{id} dan ikuti poll_url yang dikembalikan oleh respons pembuatan. Gunakan /v1/videos/generations/{id} hanya untuk kompatibilitas mundur (backward compatibility).

​
Tugas Asinkron (Async Tasks)

EndpointMetodeDeskripsi
/v1/tasks/{id}GETEndpoint status tugas asinkron terpadu. Direkomendasikan saat mengikuti poll_url yang dikembalikan
Endpoint ini tidak terbatas pada video, musik, dan 3D. Beberapa tugas gambar mungkin juga menggunakan /v1/tasks/{id} sebagai path polling kanonikal.

​
Musik

EndpointMetodeDeskripsi
/v1/music/generationsPOSTBuat tugas pembuatan musik
/v1/music/generations/{id}GETPath status khusus musik
Untuk klien baru, utamakan poll_url yang dikembalikan. Jika Anda memerlukan endpoint status tugas yang tetap, gunakan /v1/tasks/{id}; simpan /v1/music/generations/{id} untuk jalur kompatibilitas khusus musik.

​
Pembuatan 3D

EndpointMetodeDeskripsi
/v1/3d/generationsPOSTBuat tugas pembuatan model 3D
/v1/3d/generations/{id}GETPath status khusus 3D
Untuk klien baru, utamakan poll_url yang dikembalikan. Jika Anda memerlukan endpoint status tugas yang tetap, gunakan /v1/tasks/{id}; simpan /v1/3d/generations/{id} untuk jalur kompatibilitas khusus 3D.

​
Model

EndpointMetodeDeskripsi
/v1/modelsGETDaftar semua model yang tersedia
/v1/models/{model}GETDapatkan info model tertentu

​
Gemini (v1beta)

Dukungan format native Google Gemini API:
EndpointMetodeDeskripsi
/v1beta/models/{model}:generateContentPOSTHasilkan konten (format Gemini)
/v1beta/models/{model}:streamGenerateContentPOSTStream hasilkan konten (format Gemini)
Endpoint Gemini mendukung autentikasi parameter query ?key= selain Bearer token standar.

​
Format Respons

Semua respons mengikuti format yang konsisten:

​
Respons Berhasil

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
Transparansi Routing

Semua respons menyertakan field _routing dengan informasi channel: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
BidangDeskripsi
channel.idIdentifier channel yang digunakan
channel.providerProvider upstream (openai, anthropic, dll.)
channel.channelTypePLATFORM (TokenLab) atau PRIVATE (BYOK)
cachedApakah respons dilayani dari cache
retryCountJumlah upaya percobaan ulang (jika ada)

​
Respons Error

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​
Rate Limit

Rate limit berbasis role dan dapat dikonfigurasi oleh administrator. Nilai default:
RolePermintaan/menit
User60
Partner300
VIP1,000
Hubungi dukungan untuk rate limit kustom. Nilai tepatnya dapat bervariasi tergantung konfigurasi akun.
Ketika rate limit terlampaui, API mengembalikan kode status 429 dengan header Retry-After yang menunjukkan berapa lama harus menunggu.

​
Spesifikasi OpenAPI

Spesifikasi OpenAPI

Unduh spesifikasi lengkap OpenAPI 3.0