Pular para o conteúdo principal

​
Synthetic

A Synthetic expõe endpoints compatíveis com Anthropic. O OpenClaw a registra como o provedor synthetic e usa a API Anthropic Messages.
PropriedadeValor
Provedorsynthetic
AutenticaçãoSYNTHETIC_API_KEY
APIAnthropic Messages
URL basehttps://api.synthetic.new/anthropic

​
Primeiros passos

1

Obtenha uma chave de API

Obtenha uma SYNTHETIC_API_KEY na sua conta Synthetic, ou deixe o assistente de onboarding solicitá-la.
2

Execute o onboarding

openclaw onboard --auth-choice synthetic-api-key
3

Verifique o modelo padrão

Após o onboarding, o modelo padrão será:
synthetic/hf:MiniMaxAI/MiniMax-M2.5
O cliente Anthropic do OpenClaw acrescenta /v1 à URL base automaticamente, então use https://api.synthetic.new/anthropic (não /anthropic/v1). Se a Synthetic alterar sua URL base, substitua models.providers.synthetic.baseUrl.

​
Exemplo de configuração

{
  env: { SYNTHETIC_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "hf:MiniMaxAI/MiniMax-M2.5",
            name: "MiniMax M2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 192000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

​
Catálogo de modelos

Todos os modelos da Synthetic usam custo 0 (entrada/saída/cache).
ID do modeloJanela de contextoMáx. de tokensRaciocínioEntrada
hf:MiniMaxAI/MiniMax-M2.5192,00065,536nãotext
hf:moonshotai/Kimi-K2-Thinking256,0008,192simtext
hf:zai-org/GLM-4.7198,000128,000nãotext
hf:deepseek-ai/DeepSeek-R1-0528128,0008,192nãotext
hf:deepseek-ai/DeepSeek-V3-0324128,0008,192nãotext
hf:deepseek-ai/DeepSeek-V3.1128,0008,192nãotext
hf:deepseek-ai/DeepSeek-V3.1-Terminus128,0008,192nãotext
hf:deepseek-ai/DeepSeek-V3.2159,0008,192nãotext
hf:meta-llama/Llama-3.3-70B-Instruct128,0008,192nãotext
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8524,0008,192nãotext
hf:moonshotai/Kimi-K2-Instruct-0905256,0008,192nãotext
hf:moonshotai/Kimi-K2.5256,0008,192simtext + image
hf:openai/gpt-oss-120b128,0008,192nãotext
hf:Qwen/Qwen3-235B-A22B-Instruct-2507256,0008,192nãotext
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct256,0008,192nãotext
hf:Qwen/Qwen3-VL-235B-A22B-Instruct250,0008,192nãotext + image
hf:zai-org/GLM-4.5128,000128,000nãotext
hf:zai-org/GLM-4.6198,000128,000nãotext
hf:zai-org/GLM-5256,000128,000simtext + image
hf:deepseek-ai/DeepSeek-V3128,0008,192nãotext
hf:Qwen/Qwen3-235B-A22B-Thinking-2507256,0008,192simtext
As refs de modelo usam o formato synthetic/<modelId>. Use openclaw models list --provider synthetic para ver todos os modelos disponíveis na sua conta.
Se você ativar uma lista de permissões de modelos (agents.defaults.models), adicione todos os modelos Synthetic que planeja usar. Modelos que não estiverem na lista de permissões ficarão ocultos para o agente.
Se a Synthetic alterar seu endpoint de API, substitua a URL base na sua configuração:
{
  models: {
    providers: {
      synthetic: {
        baseUrl: "https://new-api.synthetic.new/anthropic",
      },
    },
  },
}
Lembre-se de que o OpenClaw acrescenta /v1 automaticamente.

​
Relacionados

Provedores de modelo

Regras de provedor, refs de modelo e comportamento de failover.

Referência de configuração

Esquema completo de configuração, incluindo ajustes de provedor.

Synthetic

Painel da Synthetic e documentação da API.