✨ Skill Integrasi API TokenLab

Baca halaman ini dan tambahkan TokenLab Skill ke agen saya saat ini. Periksa versi serta konfigurasi aktif, lalu pertahankan akun, penyedia, izin, dan pengaturan yang ada. Cadangkan berkas dan tampilkan perubahan. Saya akan memasukkan API key secara lokal; jangan meminta atau menampilkannya di chat. Periksa pemuatan konfigurasi dan jelaskan tes berbayar sebelum menjalankannya.
https://tokenlab.sh/docs/id/integrations/coding-agent-skill

Apa yang dilakukan skill iniCopy Anchor Link

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

InstalasiCopy Anchor Link

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

Perbarui instalasi yang adaCopy Anchor Link

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

Verifikasi instalasiCopy Anchor Link

Tanyakan ke coding agent Anda:

Skills apa saja yang tersedia?

Jika tokenlab-api-integration terlihat, instalasi berhasil.

Dapatkan API KeyCopy Anchor Link

Alur Agent yang disarankanCopy Anchor Link

Baca daftar model terkini, lalu tokenlab.accepted_request_formats dan bidang permintaan publik model yang dipilih. Pertahankan satu format untuk percakapan dan pemanggilan alat; bidang tidak dikonversi otomatis. Jangan mengganti model atau protokol atas inisiatif sendiri saat terjadi kesalahan.

Contoh chat minimalCopy Anchor Link

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-5.6-luna",
    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 modelCopy Anchor Link

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 $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# Daftar pendek non-chat berperingkat
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer $TOKENLAB_API_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 $TOKENLAB_API_KEY"

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

Pemilihan protokol nativeCopy Anchor Link

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-FirstCopy Anchor Link

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

Utamakan status HTTP dan code kesalahan. Gunakan did_you_mean untuk nama yang salah, tetapi jangan mengganti model tanpa pilihan pengguna. Untuk 429, ikuti Retry-After atau retry_after dan ulangi hanya jika diizinkan kesalahan serta dipilih secara eksplisit. Perbaiki dahulu kesalahan validasi, autentikasi, saldo, atau izin. Jika pembuatan permintaan timeout, periksa apakah tugas sudah ada sebelum mengirim ulang.

Keluarga API yang didukungCopy Anchor Link

Praktik terbaikCopy Anchor Link

FAQCopy Anchor Link

Sumber dayaCopy Anchor Link

Untuk masalah API atau akun, gunakan Dukungan dalam aplikasi, periksa pratinjau lalu kirim secara eksplisit. Untuk permintaan tertentu, mulai dari Permintaan dan panduan investigasi. Laporkan cacat Skill melalui GitHub Issues.