Saltar para o conteúdo principal

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.

Este skill ensina seu agente de programação a integrar as centenas de APIs de IA da TokenLab apenas descrevendo o que você precisa. Ele é empacotado como um skill compartilhado agent-first e funciona com qualquer agente de programação que suporte arquivos de skill ou regras.A API é Agent-First — mesmo que o agente adivinhe errado o nome de um modelo, a resposta de erro informa exatamente como corrigir isso.
Esta página documenta uma camada reutilizável de empacotamento de skill, e não uma superfície de compatibilidade de protocolo. Se você precisa de configuração de ponto de terminação, SDK ou cliente, use as páginas de integração dedicadas dessas ferramentas.

​
Como Funciona

  1. Você descreve o que precisa — “Quero usar GPT-4 no meu projeto Python”
  2. O agente chama a API — ele pode adivinhar um nome de modelo ou ponto de terminação
  3. Se algo der errado — a API retorna dicas estruturadas (did_you_mean, suggestions, retry_after)
  4. O agente se autocorrige — lê as dicas e tenta novamente com os parâmetros corretos
  5. Você recebe código funcional — normalmente na primeira ou segunda tentativa

​
Instalação

Use o comando de instalação canônico não interativo:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y
Isso instala o skill compartilhado tokenlab-api-integration do repositório de skills da TokenLab.Se sua ferramenta não suportar o instalador, copie a pasta skills/tokenlab-api-integration/ do repositório para o diretório compartilhado de skills ou regras da sua ferramenta.

​
Verificar Instalação

Pergunte ao seu agente de programação: 
Quais skills estão disponíveis?
Se você vir tokenlab-api-integration, a instalação foi bem-sucedida.

​
Obtenha sua API Key

1

Visite a TokenLab

Acesse tokenlab.sh
2

Faça login

Crie uma conta ou entre
3

Obtenha a API Key

Navegue até Dashboard → API Keys e crie uma nova chave
4

Copie a chave

Sua chave começa com sk-... — salve-a com segurança
Você não precisa colar uma API key em prompts ou arquivos-fonte. O skill deve perguntar qual variável de ambiente usar e gerar código que leia a key dessa variável.

​
Exemplos

​
Conclusão de Chat

Você diz: 
Quero usar GPT-4 no meu projeto Python
O agente gera: 
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)
Execute com: 
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py
Se o agente adivinhar um nome de modelo errado (ex.: gpt5), a API retorna: 
{
  "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."
  }
}
O agente lê did_you_mean, corrige o nome do modelo e tenta novamente — tudo automaticamente.

​
Geração de Imagens

Você diz: 
Generate images with Flux in Node.js
O agente chama a API de imagem, lida com erros e gera código completo com lógica de download e salvamento.

​
Reconhecimento de Fala

Você diz: 
Integrate speech-to-text in my app
O agente gera código com o ponto de terminação correto /v1/audio/transcriptions e tratamento de arquivo de áudio.

​
Recuperação de Erros Agent-First

Toda resposta de erro inclui dicas estruturadas que qualquer agente de programação pode interpretar. Veja a referência completa da API Agent-First para mais detalhes.
ErrorO que a API retornaO que o agente faz
Nome de modelo incorretodid_you_mean + suggestionsCorrige automaticamente e tenta novamente
Saldo insuficientebalance_usd + suggestions mais baratasMuda para um modelo acessível
Modelo indisponívelalternatives + retry_afterMuda para um modelo disponível
Rate limitedretry_after (segundos exatos)Aguarda e tenta novamente
Contexto muito longosuggestions com modelos maioresMuda para um modelo com contexto maior
Incompatibilidade de contrato em solicitação não chatsupported_operations, supported_parameters, request_endpoint, recommended_requestReconstrói a solicitação a partir do contrato público do modelo

​
Otimização de Endpoint Nativo

Quando você chama /v1/chat/completions com um modelo Claude ou Gemini, a API retorna cabeçalhos de otimização: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
Trate esses headers como dicas de roteamento, não como uma troca automática obrigatória. Chamadas nativas do Claude usam /v1/messages; chamadas nativas do Gemini devem seguir o endpoint indicado por X-LemonData-Native-Endpoint, geralmente /v1beta/gemini.

​
Descoberta de Modelos

Não é necessário procurar na documentação: 
# Visão geral da API legível por máquina
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"

# Lista recomendada para cenários não 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"

# Leia o contrato público de um modelo antes de repetir uma solicitação não chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Filtrar por capacidade
curl "https://api.tokenlab.sh/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
Capacidades Suportadas

TipoExemplos
ChatGPT-5.4, Claude, Gemini, DeepSeek
Geração de ImagensGPT Image, Flux, Stable Diffusion, modelos de imagem Gemini
Geração de VídeoSora, Kling, Veo, Seedance
Geração de MúsicaSuno
Modelos 3DTripo3D
ÁudioTexto para fala, fala para texto
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
Boas Práticas

Segurança da API Key

Use variáveis de ambiente. Nunca faça commit de chaves no git nem as exponha em código frontend.

Gestão de Custos

Defina limites de uso no seu dashboard. Verifique error.balance_usd para monitorar custos programaticamente.

Seja Direto

Diga “Quero gerar imagens em Python” em vez de “A TokenLab tem uma API de imagem?”

Descreva Seu Cenário

“Estou criando um chatbot com GPT-4” dá ao agente mais contexto do que “Use GPT-4”.

​
FAQ

Tente mencionar “TokenLab” ou “TokenLab API” na sua solicitação:
Quero integrar GPT-4 ao meu projeto usando TokenLab
A API Agent-First da TokenLab retorna dicas de erro estruturadas. Se o agente adivinhar um nome de modelo errado, o erro inclui did_you_mean com o nome correto e suggestions com alternativas. O agente lê isso e corrige automaticamente na próxima tentativa.
Qualquer agente de programação que suporte diretórios compartilhados de skills ou regras. Quando o instalador é suportado, npx skills add coloca automaticamente o skill compartilhado tokenlab-api-integration no local detectado.
Execute o instalador novamente:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

​
Recursos

API Agent-First

Referência completa para dicas de erro estruturadas

Documentação da API

Referência completa da API

Modelos

Navegue por centenas de modelos disponíveis

llms.txt

Visão geral da API legível por máquina para agentes de IA
Tem dúvidas? Consulte nossas GitHub Issues ou entre em contato com support@tokenlab.sh