✨ Skill tích hợp TokenLab API

Đọc trang này và thêm TokenLab Skill vào tác tử hiện tại. Kiểm tra phiên bản và cấu hình đang dùng, giữ nguyên tài khoản, nhà cung cấp, quyền và thiết lập hiện có. Sao lưu tệp và hiển thị thay đổi. Tôi sẽ nhập API key cục bộ; không yêu cầu hoặc hiển thị khóa trong chat. Kiểm tra việc tải cấu hình trước, rồi giải thích mọi thử nghiệm có tính phí trước khi chạy.
https://tokenlab.sh/docs/vi/integrations/coding-agent-skill

Skill này làm gìCopy Anchor Link

• Tạo ví dụ tối thiểu chạy được cho các nhóm API TokenLab như chat, image, audio, video, translation và nhiều nhóm khác.
• Dùng https://api.tokenlab.sh/v1 cho client tương thích OpenAI và giải thích khi nào nên chuyển sang route native Anthropic hoặc Gemini.
• Khám phá model bằng /v1/models, /llms.txt và danh sách recommended_for thay vì đoán từ danh sách cũ.
• Đọc chi tiết model của model trước khi thử lại yêu cầu non-chat để không âm thầm bỏ các trường không hỗ trợ.
• Xử lý gợi ý lỗi Agent-First như did_you_mean, suggestions, retry_after và recommended_request.

Cài đặtCopy Anchor Link

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

Cập nhật bản cài hiện cóCopy Anchor Link

Nếu bạn đã cài skill trước đó, hãy chạy lại cùng lệnh để cập nhật lên gói public hiện tại.

Kiểm tra cài đặtCopy Anchor Link

Hỏi coding agent của bạn:

Có những skills nào?

Nếu thấy tokenlab-api-integration, cài đặt đã thành công.

Lấy API KeyCopy Anchor Link

Quy trình Agent được khuyến nghịCopy Anchor Link

Đọc danh sách mô hình hiện tại, rồi đọc tokenlab.accepted_request_formats và các trường yêu cầu công khai của mô hình đã chọn. Giữ cùng định dạng cho hội thoại và lệnh gọi công cụ; các trường không tự chuyển đổi giữa định dạng. Không tự đổi mô hình hoặc giao thức khi gặp lỗi.

Ví dụ chat tối thiểuCopy Anchor Link

Ví dụ này dùng OpenAI Python SDK với base URL của 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)

Chạy bằng:

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

Khám phá model và chi tiết modelCopy Anchor Link

Ưu tiên khám phá trực tiếp thay vì danh sách đóng gói đã cũ:

# Tổng quan API đọc được bằng máy
curl https://api.tokenlab.sh/llms.txt

# Liệt kê 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"

# Danh sách đề xuất có xếp hạng cho non-chat
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"

# Đọc chi tiết model của một model trước khi thử lại yêu cầu non-chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# Chi tiết chỉ về giá
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer $TOKENLAB_API_KEY"

Chọn giao thức nativeCopy Anchor Link

Đường dẫn tương thích OpenAI /v1 là mặc định cho ví dụ chat, image, embedding, audio và rerank phổ biến. Không suy ra khả năng dùng giao thức native từ tên model, tên nhà cung cấp hoặc header phản hồi Chat. Hãy đọc GET /v1/models/{model} và chỉ dùng định dạng yêu cầu được công bố trong chi tiết model.

Trường cần đọc là tokenlab.accepted_request_formats.

Các endpoint là /v1/chat/completions cho Chat Completions, /v1/responses cho Responses, /v1/messages cho Messages, và /v1beta/models/{model}:generateContent cho Gemini.

Phục hồi lỗi Agent-FirstCopy Anchor Link

Lỗi bao gồm các trường mà coding agent có thể phân tích mà không cần đọc thủ công tài liệu:

Ưu tiên trạng thái HTTP và code của lỗi. Có thể tham khảo did_you_mean khi sai tên, nhưng không đổi mô hình nếu người dùng chưa chọn. Với 429, tuân theo Retry-After hoặc retry_after và chỉ thử lại khi lỗi cho phép và đã có lựa chọn rõ ràng. Sửa lỗi xác thực dữ liệu, xác thực tài khoản, số dư hoặc quyền trước. Nếu yêu cầu tạo bị hết thời gian chờ, kiểm tra tác vụ đã tồn tại trước khi gửi lại.

Các nhóm API được hỗ trợCopy Anchor Link

Thực hành tốt nhấtCopy Anchor Link

FAQCopy Anchor Link

Tài nguyênCopy Anchor Link

Với vấn đề API hoặc tài khoản, dùng Hỗ trợ trong ứng dụng, xem lại bản xem trước rồi chủ động gửi. Với yêu cầu cụ thể, bắt đầu từ Yêu cầu và hướng dẫn điều tra. Báo lỗi của Skill tại GitHub Issues.