Pular para o conteúdo principal

​
Como o Synthetic funciona

O Synthetic é um serviço por assinatura que executa LLMs de codificação open-source em infraestrutura dedicada e os serve por uma API compatível com OpenAI (e Anthropic). Em vez de pagar por token, você paga uma assinatura mensal fixa e obtém um orçamento generoso de limite de taxa cobrindo todos os modelos da plataforma. É posicionado como uma alternativa direta aos planos de 20/me^se20/mês e 200/mês do Claude para desenvolvedores que fazem muito código: o mesmo ponto de preço, limites de taxa várias vezes maiores, e sua escolha de modelos open-source. O Kodus acessa o Synthetic pelo endpoint compatível com OpenAI, então não há alterações de adaptador — apenas credenciais BYOK.

​
Visão geral dos planos

Preços e limites de taxa mudam. Sempre confirme em synthetic.new/pricing antes de escolher um plano.

​
Assinatura (recomendada para revisão de código)

PlanoPreçoLimite de taxa
Mensal~30/me^s(30/mês (1/dia)~500 mensagens por janela de 5 horas
Empresarial / baseado em usocontate o Syntheticopção pay-per-token
  • Todos os modelos padrão estão cobertos pela assinatura — escolha qualquer um alterando o campo model.
  • Os limites de taxa são aplicados em uma janela de 5 horas, não por mês — planeje a simultaneidade para caber dentro dessa janela.
  • O Synthetic não treina nos seus prompts/completions e exclui dados de API em 14 dias.

​
Modelos recomendados

O Synthetic expõe modelos usando um prefixo no estilo HuggingFace (hf:org/model). Algumas boas opções para revisão de código:
ID do modeloNotas
hf:zai-org/GLM-4.6Família GLM; equilibrado para revisão geral.
hf:moonshotai/Kimi-K2-InstructKimi K2 de contexto longo — ótimo em PRs grandes.
hf:Qwen/Qwen3-Coder-480B-A35B-InstructCodificador especializado poderoso.
hf:deepseek-ai/DeepSeek-V3.1DeepSeek V3.1; forte comportamento agêntico/de codificação.
Veja o catálogo completo em dev.synthetic.new/docs/openai/models.

​
Criando uma Chave de API

Uma conta Synthetic com assinatura ativa é necessária para usar a API.
  1. Vá para synthetic.new e crie uma conta ou faça login.
  2. Assine um plano em synthetic.new/pricing.
  3. Abra o console de desenvolvedor e crie uma chave de API. Copie-a imediatamente — você não verá a chave completa novamente.

​
Configurar o Synthetic no Kodus

O fluxo principal é BYOK no Kodus Cloud. Instalações self-hosted podem usar variáveis de ambiente como opção secundária.

​
Opção 1 — BYOK no Kodus Cloud (recomendado)

  1. Na interface do Kodus, abra Configurações → BYOK e clique em Editar no modelo Principal (ou Fallback).
  2. Alterne o formulário para o modo Personalizado para poder inserir uma URL base e um nome de modelo.
  3. Preencha os campos:
    CampoValor
    ProvedorOpenAI Compatible
    Chave de APIsua chave de API do Synthetic
    URL Basehttps://api.synthetic.new/openai/v1
    Modeloex.: hf:zai-org/GLM-4.6 (use o prefixo hf: e o caminho completo do HuggingFace)
    Máx. de Requisições Simultâneascomece com 3–5 para caber no orçamento de 5 horas em PRs maiores
    Máx. de Tokens de Saídamantenha o padrão a menos que haja truncamento
  4. Salve. O Kodus valida no endpoint e exibe qualquer erro 401 / 404 imediatamente.
  5. Abra qualquer PR para acionar uma revisão; o badge de status BYOK nas Configurações fica verde na primeira chamada bem-sucedida.
O orçamento de 500 mensagens por 5 horas é por assinatura, não por PR. Para times que fazem revisões contínuas pesadas, mantenha o Máx. de Requisições Simultâneas baixo o suficiente para que um PR grande com vários arquivos não consuma toda a janela, ou distribua o trabalho entre múltiplas assinaturas.
Configure o Synthetic como Principal e mantenha uma chave OpenAI ou Anthropic como Fallback — quando a janela de 5 horas se esgotar, o Kodus realiza o failover automaticamente e as revisões continuam fluindo.

​
Opção 2 — Self-hosted (variáveis de ambiente)

Se você executa o Kodus em Modo Fixo (provedor global único, sem BYOK por organização), configure o Synthetic no .env dos seus containers de API e worker: 
# Configuração Synthetic (Modo Fixo)
API_LLM_PROVIDER_MODEL="hf:zai-org/GLM-4.6"                    # qualquer ID de modelo do catálogo
API_OPENAI_FORCE_BASE_URL="https://api.synthetic.new/openai/v1"
API_OPEN_AI_API_KEY="sua-chave-de-api-synthetic"
Este caminho só é necessário para instalações self-hosted do Kodus que desabilitam deliberadamente o BYOK. Se o BYOK estiver habilitado na sua instância self-hosted, prefira a Opção 1 — o fluxo pela interface é o mesmo do Cloud.
Reinicie os containers de API e worker após editar o .env, e verifique: 
docker-compose logs api worker | grep -iE "synthetic|api\.synthetic"
Para a configuração completa self-hosted (domínios, chaves de segurança, banco de dados, webhooks, proxy reverso), siga o guia de implantação em VM genérica e substitua apenas o bloco de LLM pelo acima.

​
Quando escolher o Synthetic

  • Seu modelo principal é open-source (Kimi, DeepSeek, Qwen Coder, GLM) e você quer uma única fatura de taxa fixa em vez de gerenciar gastos por token de cada provedor.
  • **Você está comparando com o Claude Max (200/me^s)∗∗emtermosdethroughputderevisa~o—oSynthetica200/mês)** em termos de throughput de revisão — o Synthetic a 30/mês oferece várias vezes o orçamento de limite de taxa para modelos de codificação igualmente capazes.
  • Você quer uma boa postura de dados — o Synthetic é explícito sobre não-treinamento e retenção de prompts/completions por 14 dias.
Escolha pay-per-token (Moonshot, Fireworks, Together, Groq) se seu tráfego é variável, ou uma assinatura diferente (Z.AI GLM Coding Plan) se você especificamente quer a família GLM com compromissos por faixas.

​
Solução de problemas

  • O orçamento da assinatura é por janela de 5 horas, não por hora ou por mês. Verifique quantas requisições você enviou recentemente no painel do Synthetic.
  • Aguarde a janela avançar, reduza Máx. de Requisições Simultâneas no BYOK, ou faça upgrade/empilhe planos.
  • Configure um provedor BYOK de Fallback para que as revisões continuem funcionando enquanto você está com a taxa limitada.
  • Confirme que a chave está ativa e a assinatura está vigente no painel do Synthetic.
  • Certifique-se de que não há espaços em excesso ou aspas no valor do .env.
  • Alguns modelos maiores podem ter um cold-start na primeira vez que são usados após um período de inatividade.
  • Se a latência da primeira chamada estiver bloqueando as verificações de saúde do Kodus, aqueça o modelo enviando uma pequena requisição de teste antes de abrir PRs.
  • Confirme que seu servidor pode alcançar api.synthetic.new.
  • Revise os logs da API e do worker para o erro upstream exato.

​
Relacionados