Inti
Referensi API
Endpoint, autentikasi, header respons, dan error
Ringkasan
TokenLab mendukung endpoint yang kompatibel dengan OpenAI serta format permintaan Anthropic dan Gemini. Klien OpenAI yang sudah ada dapat menggunakan /v1; pilih format lain hanya jika aplikasi Anda memerlukan perilaku spesifik untuk API tersebut. POST /v1/responses bersifat opsional dan bergantung pada dukungan model.
Base URL
https://api.tokenlab.shAutentikasi
Permintaan model menggunakan kunci API TokenLab. Header autentikasi standar adalah:
Authorization: Bearer sk-your-api-keyGET /v1/models, GET /v1/models/{model}, GET /v1/models/{model}/pricing, dan GET /v1/pricing bersifat publik dan tidak memerlukan kunci. Anthropic Messages juga menerima x-api-key; Gemini menerima x-goog-api-key atau ?key= serta autentikasi Bearer. /v1/management/* memerlukan token manajemen (mt-...).
Dapatkan kunci API Anda dari Konsol.
Kebijakan Pengiriman
Permintaan pembuatan menerima X-TokenLab-Delivery-Policy: auto | verified | official. Header permintaan akan menggantikan pengaturan kunci API, yang kemudian menggantikan default Workspace.
Automenggunakan TokenLab Verified jika tersedia, lalu Official jika diperlukan. Anda membayar untuk opsi yang menyelesaikan permintaan Anda.TokenLab Verifiedadalah pengiriman yang diverifikasi oleh TokenLab. Harga Verified akan berlaku.Officialmenagih dengan harga Official, yaitu harga yang dipublikasikan oleh pembuat model.- Sesi realtime menggunakan kunci API atau pengaturan Workspace dan tidak menerima penggantian melalui permintaan.
Header yang tidak valid akan mengembalikan 400. Jika opsi yang diminta tidak tersedia, TokenLab mengembalikan 503 delivery_tier_unavailable beserta ID permintaan. Baca retryable: jika operasi yang dipilih tidak memiliki ketersediaan, nilainya adalah false. Jangan mengulangi permintaan yang sama tanpa perubahan.
Halaman API dengan formulir permintaan menerima kunci API TokenLab Anda dan mengirimkan permintaan nyata. Permintaan ini menggunakan saldo dan limit akun Anda. Anda juga dapat menggunakan cURL, Postman, atau SDK.
Endpoint yang Didukung
Chat & Pembuatan Teks
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/chat/completions | POST | Chat completions yang kompatibel dengan OpenAI |
/v1/messages | POST | Messages yang kompatibel dengan Anthropic |
/v1/messages/count_tokens | POST | Menghitung token input dari permintaan Messages |
/v1/messages/batches | POST, GET | Membuat dan mendaftar Message Batches |
/v1/messages/batches/{message_batch_id} | GET, DELETE | Mengambil atau menghapus Message Batch |
/v1/messages/batches/{message_batch_id}/results | GET | Membaca hasil |
/v1/messages/batches/{message_batch_id}/cancel | POST | Membatalkan Message Batch |
/v1/responses | POST | API Responses OpenAI |
/v1/responses/{id} | GET, DELETE | Mengambil atau menghapus respons yang tersimpan |
/v1/responses/compact | POST | Meringkas konteks percakapan Responses |
/v1/translations | POST | Terjemahan teks-ke-teks |
Embeddings & Rerank
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/embeddings | POST | Membuat embedding teks |
/v1/multimodal/embeddings | POST | Membuat embedding dengan model embedding multimodal |
/v1/rerank | POST | Melakukan rerank dokumen |
Keputusan
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/systemone | POST | Mengevaluasi pertanyaan keputusan bertipe |
File & Batch
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/files | POST, GET | Mengunggah dan mendaftar file |
/v1/files/{file_id} | GET, DELETE | Mengambil atau menghapus file |
/v1/files/{file_id}/content | GET | Mengunduh konten file |
/v1/batches | POST, GET | Membuat dan mendaftar batch |
/v1/batches/{batch_id} | GET | Mengambil batch |
/v1/batches/{batch_id}/cancel | POST | Membatalkan batch |
Gambar
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/images/generations | POST | Menghasilkan gambar dari teks |
/v1/images/edits | POST | Mengedit gambar |
/v1/images/variations | POST | Membuat variasi gambar |
/v1/images/generations/{id} | GET | Jalur status kompatibilitas untuk respons gambar berbasis tugas |
Model gambar mungkin mengembalikan gambar yang sudah jadi atau tugas asinkron. Jika respons menyertakan status: "pending" atau ID tugas, lakukan polling ke GET /v1/tasks/{id}.
Audio
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/audio/speech | POST | Text-to-speech (TTS) |
/v1/audio/transcriptions | POST | Speech-to-text (STT) |
/v1/audio/translations | POST | Menerjemahkan ucapan ke teks bahasa Inggris |
Realtime
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/realtime?model={model} | WS | Sesi WebSocket Realtime |
Gunakan /v1/realtime untuk upgrade WebSocket. GET /v1/realtime biasa akan mengembalikan metadata endpoint. Ini bukan antarmuka REST Realtime OpenAI; client-secret, Calls, dan endpoint sesi beta lama tidak tersedia.
Video
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/videos/generations | POST | Membuat tugas pembuatan video |
/v1/videos/generations/{id} | GET | Jalur status kompatibilitas |
/v1/videos/assets | POST, GET | Membuat dan mendaftar aset material Seedance |
/api/v3/contents/generations/tasks | POST, GET | Tugas Seedance dengan format permintaan Volcengine |
Lakukan polling GET /v1/tasks/{id} dengan id tugas. /v1/videos/generations/{id} tetap tersedia untuk integrasi yang sudah ada.
Tugas Asinkron
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/tasks/{id} | GET | Status untuk tugas asinkron apa pun |
/v1/tasks/{id} | DELETE | Membatalkan tugas asinkron |
Lakukan polling GET /v1/tasks/{id} untuk setiap tugas asinkron: gambar, video, musik, 3D, Worlds, dan transkripsi audio asinkron. Gunakan id atau task_id dari respons pembuatan. Respons pembuatan Worlds mengembalikan poll_url di bawah /v1/worlds/generations/{id}; lakukan polling ke /v1/tasks/{id} di sana juga. Jalur status per-modalitas di halaman ini adalah endpoint kompatibilitas untuk integrasi yang sudah ada.
Musik
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/music/generations | POST | Membuat tugas pembuatan musik |
/v1/music/generations/{id} | GET | Jalur status kompatibilitas |
Pembuatan 3D
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/3d/generations | POST | Membuat tugas pembuatan model 3D |
/v1/3d/generations/{id} | GET | Jalur status kompatibilitas |
Worlds
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/worlds/generations | POST | Membuat tugas pembuatan world |
/v1/worlds/list | POST | Mendaftar world |
/v1/worlds/{id} | GET, DELETE | Mengambil atau menghapus world |
/v1/worlds/media-assets/prepare-upload | POST | Menyiapkan unggahan aset media |
Model & Harga
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1/models | GET | Mendaftar semua model yang tersedia |
/v1/models/{model} | GET | Mendapatkan info model spesifik |
/v1/models/{model}/pricing | GET | Mendapatkan harga satu model |
/v1/pricing | GET | Mendaftar harga model |
Gemini (v1beta)
Dukungan format API Google Gemini asli:
| Endpoint | Metode | Deskripsi |
|---|---|---|
/v1beta/models | GET | Mendaftar model yang menerima permintaan Gemini |
/v1beta/models/{model} | GET | Mendapatkan model |
/v1beta/models/{model}:generateContent | POST | Menghasilkan konten |
/v1beta/models/{model}:streamGenerateContent | POST | Menghasilkan konten secara stream |
/v1beta/models/{model}:countTokens | POST | Menghitung token |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | File Gemini dan konten yang di-cache |
Endpoint Gemini mendukung autentikasi parameter kueri ?key= selain token Bearer standar.
Manajemen
/v1/management/* mengelola saldo, kunci API, dan webhook dengan token manajemen. Lihat API Manajemen.
Format Respons
Setiap endpoint mempertahankan format API-nya. Contoh sukses dan error di bawah menggunakan format Chat Completions.
Respons Sukses
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-5.6-terra",
"choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 20,
"total_tokens": 30
}
}Header Respons
Gunakan header ini jika tersedia.
| Header | Deskripsi |
|---|---|
X-Request-ID | Pengidentifikasi permintaan untuk dukungan dan debugging |
X-Routing-Time-MS | Non-streaming: total waktu dalam milidetik hingga respons upstream tiba, termasuk antrean dan inferensi upstream. Streaming: selalu 0. Bukan pengukuran routing atau antrean. |
X-Task-ID | Pengidentifikasi tugas asinkron publik untuk respons berbasis tugas |
X-Billing-Transaction-ID | Pengidentifikasi transaksi penagihan setelah penagihan final |
Penolakan permintaan resmi mungkin menyertakan upstream dengan error yang dilaporkan layanan dan nama layanan publik. Lihat Menangani error API.
Respons Error
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}Limit Rate
Limit bergantung pada tier akun dan berlaku per kunci API. Respons 429 membawa Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset. Lihat Limit rate untuk tier dan cara melakukan retry.
Spesifikasi OpenAPI
Spesifikasi OpenAPI
Unduh spesifikasi lengkap OpenAPI 3.1