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.sh

Autentikasi

Permintaan model menggunakan kunci API TokenLab. Header autentikasi standar adalah:

Authorization: Bearer sk-your-api-key

GET /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.

  • Auto menggunakan TokenLab Verified jika tersedia, lalu Official jika diperlukan. Anda membayar untuk opsi yang menyelesaikan permintaan Anda.
  • TokenLab Verified adalah pengiriman yang diverifikasi oleh TokenLab. Harga Verified akan berlaku.
  • Official menagih 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

EndpointMetodeDeskripsi
/v1/chat/completionsPOSTChat completions yang kompatibel dengan OpenAI
/v1/messagesPOSTMessages yang kompatibel dengan Anthropic
/v1/messages/count_tokensPOSTMenghitung token input dari permintaan Messages
/v1/messages/batchesPOST, GETMembuat dan mendaftar Message Batches
/v1/messages/batches/{message_batch_id}GET, DELETEMengambil atau menghapus Message Batch
/v1/messages/batches/{message_batch_id}/resultsGETMembaca hasil
/v1/messages/batches/{message_batch_id}/cancelPOSTMembatalkan Message Batch
/v1/responsesPOSTAPI Responses OpenAI
/v1/responses/{id}GET, DELETEMengambil atau menghapus respons yang tersimpan
/v1/responses/compactPOSTMeringkas konteks percakapan Responses
/v1/translationsPOSTTerjemahan teks-ke-teks

Embeddings & Rerank

EndpointMetodeDeskripsi
/v1/embeddingsPOSTMembuat embedding teks
/v1/multimodal/embeddingsPOSTMembuat embedding dengan model embedding multimodal
/v1/rerankPOSTMelakukan rerank dokumen

Keputusan

EndpointMetodeDeskripsi
/v1/systemonePOSTMengevaluasi pertanyaan keputusan bertipe

File & Batch

EndpointMetodeDeskripsi
/v1/filesPOST, GETMengunggah dan mendaftar file
/v1/files/{file_id}GET, DELETEMengambil atau menghapus file
/v1/files/{file_id}/contentGETMengunduh konten file
/v1/batchesPOST, GETMembuat dan mendaftar batch
/v1/batches/{batch_id}GETMengambil batch
/v1/batches/{batch_id}/cancelPOSTMembatalkan batch

Gambar

EndpointMetodeDeskripsi
/v1/images/generationsPOSTMenghasilkan gambar dari teks
/v1/images/editsPOSTMengedit gambar
/v1/images/variationsPOSTMembuat variasi gambar
/v1/images/generations/{id}GETJalur 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

EndpointMetodeDeskripsi
/v1/audio/speechPOSTText-to-speech (TTS)
/v1/audio/transcriptionsPOSTSpeech-to-text (STT)
/v1/audio/translationsPOSTMenerjemahkan ucapan ke teks bahasa Inggris

Realtime

EndpointMetodeDeskripsi
/v1/realtime?model={model}WSSesi 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

EndpointMetodeDeskripsi
/v1/videos/generationsPOSTMembuat tugas pembuatan video
/v1/videos/generations/{id}GETJalur status kompatibilitas
/v1/videos/assetsPOST, GETMembuat dan mendaftar aset material Seedance
/api/v3/contents/generations/tasksPOST, GETTugas 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

EndpointMetodeDeskripsi
/v1/tasks/{id}GETStatus untuk tugas asinkron apa pun
/v1/tasks/{id}DELETEMembatalkan 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

EndpointMetodeDeskripsi
/v1/music/generationsPOSTMembuat tugas pembuatan musik
/v1/music/generations/{id}GETJalur status kompatibilitas

Pembuatan 3D

EndpointMetodeDeskripsi
/v1/3d/generationsPOSTMembuat tugas pembuatan model 3D
/v1/3d/generations/{id}GETJalur status kompatibilitas

Worlds

EndpointMetodeDeskripsi
/v1/worlds/generationsPOSTMembuat tugas pembuatan world
/v1/worlds/listPOSTMendaftar world
/v1/worlds/{id}GET, DELETEMengambil atau menghapus world
/v1/worlds/media-assets/prepare-uploadPOSTMenyiapkan unggahan aset media

Model & Harga

EndpointMetodeDeskripsi
/v1/modelsGETMendaftar semua model yang tersedia
/v1/models/{model}GETMendapatkan info model spesifik
/v1/models/{model}/pricingGETMendapatkan harga satu model
/v1/pricingGETMendaftar harga model

Gemini (v1beta)

Dukungan format API Google Gemini asli:

EndpointMetodeDeskripsi
/v1beta/modelsGETMendaftar model yang menerima permintaan Gemini
/v1beta/models/{model}GETMendapatkan model
/v1beta/models/{model}:generateContentPOSTMenghasilkan konten
/v1beta/models/{model}:streamGenerateContentPOSTMenghasilkan konten secara stream
/v1beta/models/{model}:countTokensPOSTMenghitung token
/v1beta/files, /v1beta/cachedContentsPOST, GET, DELETEFile 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.

HeaderDeskripsi
X-Request-IDPengidentifikasi permintaan untuk dukungan dan debugging
X-Routing-Time-MSNon-streaming: total waktu dalam milidetik hingga respons upstream tiba, termasuk antrean dan inferensi upstream. Streaming: selalu 0. Bukan pengukuran routing atau antrean.
X-Task-IDPengidentifikasi tugas asinkron publik untuk respons berbasis tugas
X-Billing-Transaction-IDPengidentifikasi 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

Di halaman ini