提供商

Synthetic

Synthetic 提供 Anthropic 兼容端点。 OpenClaw 将它注册为 synthetic provider,并使用 Anthropic Messages API。

属性
提供商 synthetic
认证 SYNTHETIC_API_KEY
API Anthropic Messages
基础 URL https://api.synthetic.new/anthropic

入门指南

  • 获取 API 密钥

    从你的 Synthetic 账户获取一个 SYNTHETIC_API_KEY,或者让新手引导向导提示你输入。

  • 运行新手引导

    openclaw onboard --auth-choice synthetic-api-key
    
  • 验证默认模型

    完成新手引导后,默认模型会设置为:

    synthetic/hf:MiniMaxAI/MiniMax-M2.5
    
  • 配置示例

    {
      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,
              },
            ],
          },
        },
      },
    }
    

    内置目录

    所有 Synthetic 模型的成本都为 0(输入/输出/缓存)。

    模型 ID 上下文窗口 最大 tokens 推理 输入
    hf:MiniMaxAI/MiniMax-M2.5 192,000 65,536 text
    hf:moonshotai/Kimi-K2-Thinking 256,000 8,192 text
    hf:zai-org/GLM-4.7 198,000 128,000 text
    hf:deepseek-ai/DeepSeek-R1-0528 128,000 8,192 text
    hf:deepseek-ai/DeepSeek-V3-0324 128,000 8,192 text
    hf:deepseek-ai/DeepSeek-V3.1 128,000 8,192 text
    hf:deepseek-ai/DeepSeek-V3.1-Terminus 128,000 8,192 text
    hf:deepseek-ai/DeepSeek-V3.2 159,000 8,192 text
    hf:meta-llama/Llama-3.3-70B-Instruct 128,000 8,192 text
    hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 524,000 8,192 text
    hf:moonshotai/Kimi-K2-Instruct-0905 256,000 8,192 text
    hf:moonshotai/Kimi-K2.5 256,000 8,192 text + image
    hf:openai/gpt-oss-120b 128,000 8,192 text
    hf:Qwen/Qwen3-235B-A22B-Instruct-2507 256,000 8,192 text
    hf:Qwen/Qwen3-Coder-480B-A35B-Instruct 256,000 8,192 text
    hf:Qwen/Qwen3-VL-235B-A22B-Instruct 250,000 8,192 text + image
    hf:zai-org/GLM-4.5 128,000 128,000 text
    hf:zai-org/GLM-4.6 198,000 128,000 text
    hf:zai-org/GLM-5 256,000 128,000 text + image
    hf:deepseek-ai/DeepSeek-V3 128,000 8,192 text
    hf:Qwen/Qwen3-235B-A22B-Thinking-2507 256,000 8,192 text
    模型允许列表

    如果你启用了模型允许列表(agents.defaults.models),请添加你计划使用的每个 Synthetic 模型。不在允许列表中的模型将对智能体隐藏。

    基础 URL 覆盖

    如果 Synthetic 更改了它的 API 端点,请在配置中覆盖基础 URL:

    {
      models: {
        providers: {
          synthetic: {
            baseUrl: "https://new-api.synthetic.new/anthropic",
          },
        },
      },
    }
    

    请记住,OpenClaw 会自动附加 /v1

    相关内容