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.

Skill ini mengajarkan agen coding Anda cara mengintegrasikan ratusan API AI dari TokenLab hanya dengan menjelaskan apa yang Anda butuhkan. Skill ini dikemas sebagai satu skill bersama Agent-First dan bekerja dengan agen coding apa pun yang mendukung file skill atau rules.API ini bersifat Agent-First — bahkan jika agen menebak nama model dengan salah, respons error akan memberi tahu secara tepat cara memperbaikinya.
Halaman ini mendokumentasikan lapisan pengemasan skill yang dapat digunakan ulang, bukan lapisan kompatibilitas protokol. Jika Anda membutuhkan panduan titik akhir, SDK, atau klien, gunakan halaman integrasi khusus untuk alat tersebut.
Jenis: Skill bersamaJalur utama: Pemakaian API terpandu lewat skill bersama yang dapat dipakai ulangTingkat dukungan: Upaya terbaik

​
Cara Kerjanya

  1. Anda menjelaskan apa yang Anda butuhkan — “Saya ingin menggunakan GPT-4 di project Python saya”
  2. Agen memanggil API — agen mungkin menebak nama model atau titik akhir
  3. Jika terjadi masalah — API mengembalikan petunjuk terstruktur (did_you_mean, suggestions, retry_after)
  4. Agent mengoreksi dirinya sendiri — membaca petunjuk dan mencoba lagi dengan parameter yang benar
  5. Anda mendapatkan kode yang berfungsi — biasanya pada percobaan pertama atau kedua

​
Instal

Gunakan perintah instal non-interaktif kanonis:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y
Ini menginstal skill bersama tokenlab-api-integration dari repositori skill TokenLab.Jika tool Anda tidak mendukung installer, salin folder skills/tokenlab-api-integration/ dari repositori ke direktori skill bersama atau rules milik tool Anda.

​
Verifikasi Instalasi

Tanyakan kepada agen coding Anda: 
Skill apa saja yang tersedia?
Jika Anda melihat tokenlab-api-integration, instalasi berhasil.

​
Dapatkan API Key Anda

1

Kunjungi TokenLab

Buka tokenlab.sh
2

Masuk

Buat akun atau login
3

Dapatkan API Key

Buka Dashboard → API Keys dan buat key baru
4

Salin Key

Key Anda dimulai dengan sk-... — simpan dengan aman
Anda tidak perlu menempelkan API key ke prompt atau file sumber. Skill sebaiknya menanyakan variabel environment yang akan dipakai, lalu menghasilkan kode yang membaca key dari variabel itu.

​
Contoh

​
Chat Completion

Anda mengatakan: 
Saya ingin menggunakan GPT-4 di project Python saya
Agen menghasilkan: 
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
Jalankan dengan: 
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py
Jika agen menebak nama model yang salah (mis. gpt5), API mengembalikan: 
{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.tokenlab.sh/v1/models to list all available models."
  }
}
Agen membaca did_you_mean, memperbaiki nama model, lalu mencoba lagi — semuanya secara otomatis.

​
Pembuatan Gambar

Anda mengatakan: 
Generate images with Flux in Node.js
Agen memanggil API gambar, menangani error, dan menghasilkan kode lengkap dengan logika download dan penyimpanan.

​
Pengenalan Ucapan

Anda mengatakan: 
Integrate speech-to-text in my app
Agen menghasilkan kode dengan titik akhir /v1/audio/transcriptions yang benar dan penanganan file audio.

​
Pemulihan Error Agent-First

Setiap respons error menyertakan petunjuk terstruktur yang dapat di-parse oleh agen coding apa pun. Lihat referensi lengkap API Agent-First untuk detailnya.
ErrorApa yang Dikembalikan APIApa yang Dilakukan Agen
Nama model salahdid_you_mean + suggestionsMengoreksi otomatis dan mencoba lagi
Saldo tidak mencukupibalance_usd + suggestions yang lebih murahBeralih ke model yang terjangkau
Model tidak tersediaalternatives + retry_afterBeralih ke model yang tersedia
Terkena rate limitretry_after (detik yang tepat)Menunggu lalu mencoba lagi
Context terlalu panjangsuggestions dengan model yang lebih besarBeralih ke model dengan context lebih besar
Kontrak request non-chat tidak cocoksupported_operations, supported_parameters, request_endpoint, recommended_requestMembangun ulang request dari kontrak model publik

​
Optimasi Titik Akhir Native

Saat Anda memanggil /v1/chat/completions dengan model Claude atau Gemini, API mengembalikan header optimasi: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
Perlakukan header ini sebagai petunjuk routing, bukan perpindahan otomatis yang wajib. Panggilan native Claude menggunakan /v1/messages; panggilan native Gemini harus mengikuti endpoint yang diberikan oleh X-LemonData-Native-Endpoint, biasanya /v1beta/gemini.

​
Penemuan Model

Tidak perlu mencari dokumentasi: 
# Ringkasan API yang dapat dibaca mesin
curl https://api.tokenlab.sh/llms.txt

# List models by category
curl "https://api.tokenlab.sh/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Shortlist rekomendasi untuk skenario non-chat
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-KEY"

# Baca kontrak publik satu model sebelum mencoba ulang request non-chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Filter berdasarkan kemampuan
curl "https://api.tokenlab.sh/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
Kapabilitas yang Didukung

TipeContoh
PercakapanGPT-5.4, Claude, Gemini, DeepSeek
Pembuatan GambarGPT Image, Flux, Stable Diffusion, model gambar Gemini
Pembuatan VideoSora, Kling, Veo, Seedance
Pembuatan MusikSuno
Model 3DTripo3D
AudioTeks-ke-Ucapan, Ucapan-ke-Teks
Penyematantext-embedding-3
Penyusunan Ulangbce-reranker, qwen3-rerank

​
Praktik Terbaik

Keamanan API Key

Gunakan environment variable. Jangan pernah commit key ke git atau mengeksposnya dalam kode frontend.

Manajemen Biaya

Tetapkan batas penggunaan di dashboard Anda. Periksa error.balance_usd untuk memantau biaya secara terprogram.

Bersikap Langsung

Katakan “Saya ingin membuat gambar di Python” alih-alih “Apakah TokenLab memiliki API gambar?”

Jelaskan Skenario Anda

“Saya sedang membangun chatbot dengan GPT-4” memberi agent konteks lebih banyak daripada “Gunakan GPT-4”.

​
FAQ

Coba sebutkan “TokenLab” atau “TokenLab API” dalam permintaan Anda:
Saya ingin menggunakan TokenLab untuk mengintegrasikan GPT-4 ke project saya
API Agent-First TokenLab mengembalikan petunjuk error terstruktur. Jika agen menebak nama model yang salah, error akan menyertakan did_you_mean dengan nama yang benar dan suggestions dengan alternatif. Agen membaca ini dan mengoreksi otomatis pada percobaan berikutnya.
Agen coding apa pun yang mendukung direktori skill bersama atau rules. Saat installer didukung, npx skills add menempatkan skill bersama tokenlab-api-integration di lokasi yang terdeteksi secara otomatis.
Jalankan ulang installer:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

​
Sumber Daya

API Agent-First

Referensi lengkap untuk petunjuk error terstruktur

Dokumentasi API

Referensi API lengkap

Model

Jelajahi ratusan model yang tersedia

llms.txt

Ikhtisar API yang dapat dibaca mesin untuk AI agent
Punya pertanyaan? Periksa GitHub Issues kami atau hubungi support@tokenlab.sh