✨ Skill Integrasi API TokenLab

Halaman ini mendokumentasikan skill bersama tokenlab-api-integration yang dipelihara. Distribusi kanonis berada di hedging8563/tokenlab-skills, dan repository publik sengaja hanya menyimpan skill ini.

Gunakan halaman ini untuk instalasi skill dan panduan workflow agent. Untuk setup endpoint tertentu, gunakan halaman SDK, client, atau API reference khusus alat tersebut.

Apa yang dilakukan skill ini

Membuat contoh minimal yang dapat dijalankan untuk keluarga API TokenLab seperti chat, image, audio, video, translation, dan lainnya.
Menggunakan https://api.tokenlab.sh/v1 untuk client kompatibel OpenAI dan menjelaskan kapan berpindah ke route native Anthropic atau Gemini.
Menemukan model lewat /v1/models, /llms.txt, dan daftar recommended_for alih-alih menebak dari daftar usang.
Membaca detail model model sebelum mencoba ulang permintaan non-chat agar field yang tidak didukung tidak dibuang diam-diam.
Menangani petunjuk error Agent-First seperti did_you_mean, suggestions, retry_after, dan recommended_request.

Instalasi

Gunakan perintah instalasi kanonis non-interaktif:

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Ini memasang skill bersama tokenlab-api-integration dari repository TokenLab skills.Jika alat Anda tidak mendukung installer, salin skills/tokenlab-api-integration/ dari repository ke direktori skills atau rules bersama milik alat Anda.

Perbarui instalasi yang ada

Jika Anda sudah menginstal skill sebelumnya, jalankan kembali perintah yang sama untuk memperbarui ke paket publik saat ini.

Verifikasi instalasi

Tanyakan ke coding agent Anda:

Skills apa saja yang tersedia?

Jika tokenlab-api-integration terlihat, instalasi berhasil.

Dapatkan API Key

Kunjungi TokenLab

Buka tokenlab.sh

Masuk

Buat akun atau login

Dapatkan API Key

Buka Dashboard → API Keys dan buat key baru

Salin key

Key Anda diawali sk-.... Simpan dengan aman.

Jangan tempel API keys ke prompt atau file sumber. Skill harus menanyakan variabel lingkungan yang digunakan dan menghasilkan kode yang membaca key dari variabel itu.

Alur Agent yang disarankan

Mulai dari contoh kerja terkecil yang sesuai dengan bahasa dan keluarga API yang diminta pengguna.
Saat pilihan model terbuka, panggil /v1/models atau https://api.tokenlab.sh/llms.txt sebelum meng-hardcode model.
Untuk pekerjaan non-chat, panggil /v1/models?recommended_for=<scene> dengan <scene> berupa image, video, music, 3d, tts, stt, embedding, rerank, atau translation.
Sebelum mengubah permintaan non-chat yang gagal, baca /v1/models/:model dan selaraskan dengan supported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode, dan recommended_request.
Jika API mengembalikan error Agent-First, gunakan field terstruktur untuk memperbaiki permintaan dan coba ulang hanya jika error retryable.

Contoh chat minimal

Contoh ini memakai OpenAI Python SDK dengan base URL TokenLab:

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-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Jalankan dengan:

pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py

Penemuan model dan detail model

Utamakan penemuan live daripada daftar bawaan yang usang:

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

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

# Daftar pendek non-chat berperingkat
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-KEY"

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

# Detail khusus harga
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer sk-KEY"

Pemilihan protokol native

Jalur kompatibel OpenAI /v1 adalah default untuk contoh umum chat, image, embedding, audio, dan rerank. Jangan simpulkan ketersediaan protokol native dari nama model atau provider, maupun dari header respons Chat. Baca GET /v1/models/{model} dan gunakan hanya format permintaan yang diiklankan oleh detail model. Field yang dibaca adalah tokenlab.accepted_request_formats. Endpoint protokolnya adalah /v1/chat/completions untuk Chat Completions, /v1/responses untuk Responses, /v1/messages untuk Messages, dan /v1beta/models/{model}:generateContent untuk Gemini.

Pemulihan error Agent-First

Error menyertakan field yang dapat diparse coding agent tanpa mengorek dokumentasi:

Error	Field berguna	Tindakan agent
Nama model salah	`did_you_mean`, `suggestions`, `hint`	Coba ulang dengan model yang diperbaiki atau satu alternatif yang disarankan
Saldo tidak cukup	`balance_usd`, `estimated_cost_usd`, `suggestions`	Minta persetujuan atau pindah ke model yang lebih terjangkau
Batas laju atau sementara tidak tersedia	`retryable`, `retry_after`, `alternatives`	Tunggu, coba ulang, atau pilih alternatif yang tercantum
Permintaan non-chat tidak kompatibel	`supported_operations`, `supported_parameters`, `request_endpoint`, `request_endpoint_by_operation`, `request_shape_mode`, `recommended_request`	Bangun ulang permintaan dari detail model dan kembalikan error yang jelas untuk field yang mengubah maksud

Keluarga API yang didukung

Keluarga	Path utama
Chat dan Responses	`/v1/chat/completions`, `/v1/responses`
Pesan asli Claude	`/v1/messages`
Permintaan Gemini-native	`/v1beta/models/{model}:generateContent`
Gambar	`/v1/images/generations`, `/v1/images/edits`
Video	`/v1/videos/generations`
Musik	`/v1/music/generations`
Worlds	`/v1/worlds/generations` plus endpoint status world dan media asset
3D	`/v1/3d/generations`
Audio	`/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/audio/translations`
Realtime	`/v1/realtime?model={model}`
Embeddings dan rerank	`/v1/embeddings`, `/v1/rerank`
Terjemahan teks	`/v1/translations`

Praktik terbaik

Keamanan API Key

Gunakan variabel lingkungan dan panggilan server-side. Jangan pernah mengekspos keys di kode frontend.

Kontrak dulu untuk non-chat

Baca /v1/models?recommended_for=... dan /v1/models/:model sebelum mencoba ulang permintaan image, video, music, 3D, translation, audio, embedding, atau rerank.

Contoh berjalan terkecil

Buat satu panggilan yang berfungsi sebelum menambahkan abstraksi, antrean, atau alur UI.

Gunakan petunjuk terstruktur

Parse did_you_mean, retry_after, alternatives, dan recommended_request sebelum mengubah kode.

FAQ

Skill tidak terpicu otomatis?

Sebut “TokenLab” atau “TokenLab API” dalam permintaan, misalnya: Gunakan TokenLab untuk menambahkan pembuatan gambar ke app Node.js saya.

Coding agent apa yang didukung?

Coding agent apa pun yang mendukung direktori skill atau rules bersama dapat menggunakan folder ini. Installer skills menangani agent yang didukung secara otomatis.

Bagaimana memperbarui skill?

Jalankan ulang perintah instalasi. Perintah ini menyegarkan salinan lokal dari repository publik kanonis.

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Sumber daya

Agent-First API

Petunjuk error terstruktur dan perilaku pemulihan

Dokumentasi API

Setup per endpoint dan API Reference

Model

Jelajahi model yang tersedia

llms.txt

Ringkasan API yang dapat dibaca mesin untuk agents

Ada pertanyaan? Gunakan GitHub Issues atau hubungi support@tokenlab.sh.

Memulai

Panduan inti

Panduan media

✨ Skill Integrasi API TokenLab

Apa yang dilakukan skill ini

Instalasi

Perbarui instalasi yang ada

Verifikasi instalasi

Dapatkan API Key

Alur Agent yang disarankan

Contoh chat minimal

Penemuan model dan detail model

Pemilihan protokol native

Pemulihan error Agent-First

Keluarga API yang didukung

Praktik terbaik

Keamanan API Key

Kontrak dulu untuk non-chat

Contoh berjalan terkecil

Gunakan petunjuk terstruktur

FAQ

Sumber daya

Agent-First API

Dokumentasi API

Model

llms.txt

​Apa yang dilakukan skill ini

​Instalasi

​Perbarui instalasi yang ada

​Verifikasi instalasi

​Dapatkan API Key

​Alur Agent yang disarankan

​Contoh chat minimal

​Penemuan model dan detail model

​Pemilihan protokol native

​Pemulihan error Agent-First

​Keluarga API yang didukung

​Praktik terbaik

Keamanan API Key

Kontrak dulu untuk non-chat

Contoh berjalan terkecil

Gunakan petunjuk terstruktur

​FAQ

​Sumber daya

Agent-First API

Dokumentasi API

Model

llms.txt

Apa yang dilakukan skill ini

Instalasi

Perbarui instalasi yang ada

Verifikasi instalasi

Dapatkan API Key

Alur Agent yang disarankan

Contoh chat minimal

Penemuan model dan detail model

Pemilihan protokol native

Pemulihan error Agent-First

Keluarga API yang didukung

Praktik terbaik

FAQ

Sumber daya