Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Início rápido das APIs de nível gratuito

Status: Ativo Escopo: estado atual Última revisão: 2026-08-28 Responsável: ax-code runtime

O AX Code não fornece cota de modelo. Uma execução “gratuita” usa cota ou créditos oferecidos por um provedor externo de modelo, cuja disponibilidade, limites, termos de dados e catálogo de modelos podem mudar independentemente do AX Code.

Caminho mais curto com suporte: Groq

A Groq é um provedor padrão do AX Code, o catálogo atual de modelos do AX Code contém modelos capazes de usar ferramentas, e a Groq publica limites do plano gratuito para esses IDs de modelo.

1. Crie uma conta na Groq e uma chave de API no Console da Groq.
2. Guarde a chave no AX Code:

ax-code providers login groq

3. Confirme os modelos disponíveis na versão instalada do AX Code:

ax-code models groq

4. Abra ax-code, execute /connect e escolha a Groq e um dos modelos listados. Para um teste rápido headless, o catálogo empacotado atual aceita:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Se esse modelo exato não for impresso por ax-code models groq, use um ID de modelo que seja. O catálogo instalado é a autoridade para a versão instalada.

Opções embutidas de nível gratuito e de crédito gratuito

Estes provedores estão no seletor padrão de configuração do AX Code. “Embutido” significa que o AX Code fornece o adaptador de protocolo, os metadados do modelo, o fluxo de credencial e o endpoint do provedor; não significa que todo modelo ou toda solicitação seja gratuito.

Para a UnoRouter, conecte com ax-code providers login unorouter, execute ax-code models unorouter e escolha um modelo cujo ID termine em :free. Não suponha que o gêmeo pago, sem esse sufixo, seja gratuito. O próprio catálogo da UnoRouter observa que nem todo modelo gratuito aceita chamada de ferramenta; o AX Code só mostra as entradas capazes de ferramenta no catálogo empacotado.

Para o Google ou a Hugging Face, conecte com o ID de provedor correspondente e depois use ax-code models google ou ax-code models huggingface. Confira a página de preços ao vivo do provedor antes de escolher um modelo.

Acrescentar o roteador de modelos gratuitos da OpenRouter

A OpenRouter documenta openrouter/free como um roteador de custo zero que seleciona um modelo gratuito disponível e compatível com a solicitação. Como esse roteador não está no instantâneo curado atual do AX Code, acrescente uma entrada local conservadora de modelo ao ax-code.json na raiz do projeto (ou mescle-a na configuração global do AX Code):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Os limites acima são valores conservadores de orçamento do AX Code, não um direito concedido pela OpenRouter. Em seguida, conecte e verifique o catálogo de modelos mesclado:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

O openrouter repetido é intencional: o primeiro segmento é o ID de provedor do AX Code e openrouter/free é o ID de modelo esperado pela OpenRouter. A disponibilidade e a seleção do roteador gratuito variam por solicitação; veja a documentação do roteador gratuito da OpenRouter.

Como usar o catálogo externo de APIs gratuitas

awesome-free-llm-apis é útil para descobrir ofertas atuais, mas não é uma lista de compatibilidade nem de endosso do AX Code:

• Um provedor em Provedores e modelos com suporte tem um preset padrão de configuração do AX Code.
• Um provedor que apenas aparece em models-snapshot.json tem apoio do registro, mas não está necessariamente curado para o fluxo padrão de configuração.
• Outro serviço pode funcionar por Provedores personalizados e gateways quando expõe um endpoint compatível com OpenAI ou Anthropic.
• “Compatível com a OpenAI” é necessário, mas não basta para um agente de código. O modelo escolhido também precisa de respostas de texto em fluxo e de chamada confiável de ferramenta ou função.
• Nomes de provedor, IDs de modelo, cotas gratuitas, regiões e requisitos de conta em listas de terceiros podem ficar desatualizados. Confira-os nas páginas oficiais de preço, de modelo e de limite de taxa do provedor antes de depender deles.

Na data de revisão desta página, os serviços nomeados por esse catálogo se mapeiam ao AX Code assim:

Em particular, o preset github-copilot não é a API github-models listada por alguns catálogos. Não substitua um ID de provedor ou um fluxo de credencial pelo outro. As APIs gerais zai e zhipuai começam no GLM-5.3; SKUs mais antigos de GLM 3, GLM 4, GLM-5 e GLM-5.2 continuam filtrados.

Práticas seguras de avaliação

• Teste primeiro com um repositório público ou descartável. Um provedor ou gateway hospedado recebe os prompts e o contexto de código enviados à API dele.
• Ative o isolamento workspace-write, ou use read-only para um teste rápido só de revisão.
• Comece com uma tarefa curta e um agente. Council, arena, sessões longas e repositórios grandes podem consumir muitas solicitações e bater rápido nos limites do nível gratuito.
• Guarde credenciais com ax-code providers login ou uma variável de ambiente; nunca envie chaves de API para ax-code.json.
• Trate 429 e a indisponibilidade temporária como restrições normais do nível gratuito. Espere a janela de nova tentativa do provedor ou escolha outro modelo gratuito listado no momento.