Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
Base URLhttps://api.synthetic.new/anthropic

Primeiros passos

1

Obter uma chave de API

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

Executar o onboarding

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

Verificar o modelo padrão

Após o onboarding, o modelo padrão é definido como:
synthetic/hf:MiniMaxAI/MiniMax-M2.5
O cliente Anthropic do OpenClaw acrescenta /v1 à base URL automaticamente, então use https://api.synthetic.new/anthropic (não /anthropic/v1). Se a Synthetic alterar sua base URL, sobrescreva 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 integrado

Todos os modelos Synthetic usam custo 0 (entrada/saída/cache).
ID do modeloJanela de contextoMáx. de tokensReasoningEntrada
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
Referências 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ê habilitar uma allowlist de modelos (agents.defaults.models), adicione todos os modelos Synthetic que pretende usar. Modelos fora da allowlist ficarão ocultos para o agente.
Se a Synthetic alterar seu endpoint de API, sobrescreva a base URL na sua configuração:
{
  models: {
    providers: {
      synthetic: {
        baseUrl: "https://new-api.synthetic.new/anthropic",
      },
    },
  },
}
Lembre-se de que o OpenClaw acrescenta /v1 automaticamente.

Relacionados

Seleção de modelo

Regras de provedor, referências de modelo e comportamento de failover.

Referência de configuração

Schema completo de configuração, incluindo definições de provedor.

Synthetic

Dashboard da Synthetic e documentação da API.