Primeiros passos

Início Rápido

Envie sua primeira requisição à API do TokenLab com cURL, Python, JavaScript, Go ou PHP. Configure a chave de API e o endpoint e confira a resposta de Chat Completions.

Passo 1: Crie uma conta e adicione fundos

Crie uma conta

Cadastre-se em tokenlab.sh usando seu e-mail, Gmail ou conta do GitHub.

Conferir o saldo do workspace

Confira o saldo disponível em Faturamento. A solicitação é cobrada pelo preço atual do modelo; adicione fundos se necessário.

Criar e salvar uma chave de API

Abra Chaves de API no seu espaço de trabalho. Crie uma chave e salve o valor completo imediatamente; ele é exibido apenas uma vez. Se você já salvou uma chave completa, use esse valor. O prefixo exibido ou copiado da lista não autentica requisições.

Mantenha sua chave de API segura. Nunca a exponha em código do lado do cliente ou em repositórios públicos.

Definir a chave para este terminal

Os comandos não incluem a chave no próprio comando. Ela vale apenas para o terminal atual e seus processos filhos. Em aplicações implantadas, use um gerenciador de segredos.

printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY

Passo 2: Instale um cliente

pip install openai

Passo 3: Faça sua primeira requisição

Para a maioria das novas integrações, comece com Chat Completions em POST /v1/chat/completions.

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'

Salve um exemplo SDK como quickstart.py, quickstart.mjs, main.go ou quickstart.php e execute python quickstart.py, node quickstart.mjs, go run . ou php quickstart.php. Python, JavaScript e Go usam SDKs oficiais da OpenAI; PHP usa o cliente comunitário, com PHP 8.2+.

Use POST /v1/responses somente quando você precisar explicitamente do comportamento específico de Responses. Alguns campos exclusivos de Responses dependem do modelo selecionado e do caminho roteado.

Conferir o resultado

Uma solicitação bem-sucedida retorna uma resposta não vazia. Confira modelo, status e uso em Solicitações no mesmo workspace. Consulte a solução de problemas para erros e o guia SDK para trocar de modelo ou usar streaming.

Próximos passos

Nesta página