Documentação

Tudo o que precisa para começar a integrar IA nas suas aplicações.

Início Rápido Autenticação Chat Completions Modelos Erros

Início Rápido

Criar conta e obter API Key

Registe-se em token.ao/app e aceda ao Dashboard para gerar a sua primeira chave de API.

Instalar o SDK

Terminal

npm install openai

Fazer a primeira chamada

index.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.token.ao/v1',
  apiKey: 'tk_live_sua_chave_aqui',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Olá!' }],
});

console.log(response.choices[0].message.content);

Autenticação

Todas as chamadas à API requerem uma chave válida enviada no header Authorization.

Header

Authorization: Bearer tk_live_sua_chave_aqui

Chat Completions

POST /v1/chat/completions

Request

request.json

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "És um assistente útil."
    },
    {
      "role": "user",
      "content": "O que é a Token.ao?"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1024
}

Response

response.json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "A Token.ao é..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 156,
    "total_tokens": 184
  }
}

Modelos Disponíveis

Modelo	Provedor	Contexto
gpt-4o	OpenAI	128K
gpt-4o-mini	OpenAI	128K
claude-3-5-sonnet	Anthropic	200K
gemini-1.5-pro	Google	1M
llama-3.1-70b	Meta	128K
mistral-large	Mistral	128K

Códigos de Erro

Código	Significado	Acção
401	API Key inválida ou ausente	Verifique a chave no header Authorization.
402	Saldo insuficiente	Recarregue a sua carteira no Dashboard.
429	Rate limit atingido	Aguarde e tente novamente. Considere reduzir a frequência.
500	Erro interno	Tente novamente. Se persistir, contacte o suporte.