Source: https://ailoot.ai/docs/pt-pt/ Canonical: https://ailoot.ai/docs/pt-pt/ Language: pt-pt [Introdução](https://ailoot.ai/docs/pt-pt/) # Início rápido — Chave de API, preços e primeiro pedido [Markdown](https://ailoot.ai/docs/pt-pt/index.md) A primeira resposta de um modelo através do Ailoot em poucos minutos: chave, endereço e um pedido. O Ailoot é uma API única para redes neuronais de várias empresas: OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside e TypeSafe. Uma chave, um saldo em dólares. O catálogo contém 1256 fichas de modelos e 2692 métodos documentados. Os identificadores alternativos de chamada ou aliases são apresentados no método selecionado, quando disponíveis. O Ailoot suporta três formatos de API: OpenAI, Anthropic e Gemini. Por isso, pode utilizar SDK existentes e quase todas as aplicações que permitam definir um endereço de API personalizado: Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n e dezenas de outras. | Método | Quando é adequado | | --- | --- | | [Pedido HTTP](https://ailoot.ai/docs/pt-pt/connect/curl/) | Qualquer linguagem, sem dependências, para verificar rapidamente a chave | | [OpenAI SDK](https://ailoot.ai/docs/pt-pt/connect/openai-sdk/) | Python e Node.js; quaisquer modelos do catálogo no formato OpenAI | | [Anthropic SDK](https://ailoot.ai/docs/pt-pt/connect/anthropic-sdk/) | Claude e outros modelos no formato Messages | | [Aplicações prontas a utilizar](https://ailoot.ai/integrations/pt-pt/) | 85 agentes, editores e chats: 77 com configuração pronta e mais 8 em verificação | Precisa de uma aplicação específica? Abra o [catálogo de integrações](https://ailoot.ai/integrations/pt-pt/): para cada aplicação, indica onde inserir o endereço e a chave e fornece uma configuração pronta a copiar. ## [](https://ailoot.ai/docs/pt-pt/#key)Obtenha a chave 1. **Registe-se** Crie uma conta em [ailoot.ai/register](https://ailoot.ai/register). Depois, inicie sessão através de [ailoot.ai/login](https://ailoot.ai/login). 2. **Carregue o saldo** Na área pessoal, abra a secção «Tarifários»: carregamento pontual a partir de $18 ou subscrição com bónus de saldo. Saiba mais: [carregamento](https://ailoot.ai/docs/pt-pt/billing/topup/) e [subscrições](https://ailoot.ai/docs/pt-pt/billing/subscriptions/). 3. **Crie uma chave de API** Na área pessoal, abra a secção de chaves e crie uma nova. A chave começa por `sk-`. Pode copiá-la na secção de chaves da área pessoal; guarde-a como uma palavra-passe. Guarde a chave numa variável de ambiente ```bash export AILOOT_API_KEY="sk-..." # verificação: deve ser devolvida uma lista de modelos curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300 ``` ## [](https://ailoot.ai/docs/pt-pt/#first-request)Envie o primeiro pedido O endereço da API é `https://api.ailoot.ai`. Para SDK no formato OpenAI, o endereço de base é `https://api.ailoot.ai/v1`; para Anthropic e Gemini — `https://api.ailoot.ai` sem sufixo: estes SDK acrescentam automaticamente o caminho. ```bash curl https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [ {"role": "user", "content": "Explique em duas frases o que é uma API."} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "Explique em duas frases o que é uma API."}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "Explique em duas frases o que é uma API." }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # sem /v1: o SDK acrescenta /v1/messages automaticamente api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Explique em duas frases o que é uma API."}], ) print(msg.content[0].text) ``` A resposta chega no formato habitual. O bloco `usage` indica quantos tokens foram utilizados na pergunta e na resposta: são esses valores que determinam o débito. 200 OK ```json { "id": "chatcmpl-8f2c…", "object": "chat.completion", "created": 1790812800, "model": "claude-sonnet-5-5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Uma API é um acordo sobre como um programa pede a outro que faça algo…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 21, "completion_tokens": 48, "total_tokens": 69 } } ``` ## [](https://ailoot.ai/docs/pt-pt/#streaming)Resposta em fluxo Com `"stream": true` a resposta chega no formato Server-Sent Events, tal como nas API originais, pelo que os SDK e os clientes a processam sem alterações. No OpenAI SDK, é útil pedir os dados finais de `usage` no último evento. O Ailoot entrega a resposta de texto paga após o cálculo do custo. Por isso, com `stream: true` o formato continua a ser em fluxo (SSE), mas o texto chega num único bloco quando o modelo termina, e não palavra a palavra. Se a resposta demorar mais de cerca de 15 segundos, os fluxos Chat Completions, Responses e Messages começam por linhas de serviço `: ping` (aproximadamente a cada 10 segundos), seguidas da linha `: ailoot-charged-usd …` com o valor debitado e dos dados propriamente ditos. Os SDK ignoram essas linhas. ```python stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "Escreva um haiku sobre a chuva"}], stream=True, stream_options={"include_usage": True}, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ```js const stream = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "Escreva um haiku sobre a chuva" }], stream: true, stream_options: { include_usage: true }, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "Escreva um haiku sobre a chuva"}]}' ``` ## [](https://ailoot.ai/docs/pt-pt/#models)Escolha o modelo O campo `model` — identificador exato do [catálogo de modelos](https://ailoot.ai/models/pt-pt/) ou da resposta de `GET /v1/models`. Muitos modelos têm aliases curtos, por exemplo, `claude-sonnet-latest` ou `qwen`. O catálogo mostra para que modelo aponta atualmente cada alias; para resultados reproduzíveis, utilize o ID exato. | Tarefa | Por onde começar | | --- | --- | | Código e agentes | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` | | Rápido e económico | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` | | Contexto longo até 1M tokens | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` | | Imagens | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` | Nem todos os modelos estão disponíveis em todos os formatos. Por exemplo, os modelos Gemini funcionam através de Anthropic Messages e do formato nativo Gemini; em OpenAI Chat, apenas `gemini-3.6-flash`. Os formatos disponíveis para cada modelo estão no [catálogo](https://ailoot.ai/models/pt-pt/). ## [](https://ailoot.ai/docs/pt-pt/#next)Próximos passos [**Como funciona** Caminho do pedido, reserva e débito, erros](https://ailoot.ai/docs/pt-pt/how-it-works/) [**Compatibilidade** Formatos e clientes suportados](https://ailoot.ai/docs/pt-pt/compatibility/) [**Integrações** 77 aplicações com configuração pronta](https://ailoot.ai/integrations/pt-pt/) [**Erros e limites** Códigos de resposta e o que fazer](https://ailoot.ai/docs/pt-pt/errors/) Ainda tem dúvidas? Envie o Request ID e uma descrição — ajudamos a esclarecer.[Contactar o suporte](mailto:support@ailoot.ai) ## Chave de API, preços e primeiro pedido ### Como pago a utilização da API Ailoot? Na área pessoal, abra a secção «Tarifários»: carregamento pontual a partir de $18 ou subscrição com bónus de saldo. Saiba mais: carregamento e subscrições. Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Perguntas Como enviar o primeiro pedido API? Crie uma chave API Ailoot. Defina https://api.ailoot.ai/v1 para OpenAI SDK ou https://api.ailoot.ai para Anthropic e Gemini SDK. GET /v1/models é gratuito e lista os modelos disponíveis para a sua chave; depois, use o exemplo do modelo e do método API escolhidos. Que chave API devo utilizar? Use uma chave API Ailoot da sua conta no campo de autenticação do formato escolhido para o cliente. Envie GET /v1/models com a mesma chave para verificar gratuitamente o acesso aos modelos; uma chave de outro serviço não dá acesso ao Ailoot. O que verificar se o primeiro pedido falhar? Compare o endereço API, a chave API Ailoot, o ID exato do modelo e o método API com a ficha do modelo e o exemplo de pedido. Leia o erro devolvido; se precisar de ajuda, envie o erro e o ID do pedido para support@ailoot.ai, sem a sua chave API. O que oferece a subscrição? Um desconto na compra de tokens para trabalho regular. Escolha o plano conforme o volume de pedidos; as condições e o preço da subscrição aparecem na adesão. Como aplico um código promocional com até 50% de desconto? Introduza o código promocional ao comprar tokens. O total é recalculado segundo as condições da campanha; o desconto é visível antes do pagamento. ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.