Synthetic으로 Anthropic API 모델들 똑똑하게 연결하기

여러 모델을 쓰려고 API를 일일이 맞추다 보면 정말 머리 아프죠? 특히 Anthropic 스타일의 API가 편하긴 한데, 다른 모델들도 그 방식으로 쓰고 싶을 때가 있어요.

이럴 때 Synthetic이 딱이에요. Anthropic Messages API를 그대로 쓰면서 DeepSeek나 MiniMax 같은 핫한 모델들을 바로 붙여볼 수 있거든요. OpenClaw에서 synthetic 제공자를 등록하고 바로 시작하는 방법을 정리해 드릴게요.

필요한 것

시작하기 전에 딱 두 가지만 준비해 주세요.

• 설치된 OpenClaw
• SYNTHETIC_API_KEY (Synthetic에서 발급받은 키)

빠른 시작

5분 안에 설정을 끝내는 가장 빠른 방법이에요. 터미널을 열고 아래 순서대로 따라 하세요.

1. 환경 변수로 SYNTHETIC_API_KEY를 설정하세요.
2. 아래 명령어를 실행해서 온보딩을 진행하세요.

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

기본 모델은 synthetic/hf:MiniMaxAI/MiniMax-M2.1로 설정될 거예요.

Config example

설정 파일에 직접 넣고 싶다면 아래 JSON5 예시를 참고하세요. baseUrl 설정이 중요한데, 뒤에 /v1을 붙이지 않는 게 포인트예요.

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

OpenClaw의 Anthropic 클라이언트는 baseUrl 뒤에 자동으로 /v1을 붙여요. 그래서 주소를 적을 때 https://api.synthetic.new/anthropic/v1이 아니라 https://api.synthetic.new/anthropic까지만 적어야 해요.

문제 해결

설정하다가 막히면 이 부분을 확인해 보세요.

• 404 에러가 나요: baseUrl 끝에 /v1이 중복으로 들어갔는지 확인해 보세요. OpenClaw가 자동으로 붙여주니까 꼭 빼야 해요.
• 모델을 찾을 수 없대요: agents.defaults.models에서 허용 목록(allowlist)을 쓰고 있다면, 사용하려는 모델 ID를 모두 추가했는지 체크해 보세요.

다음 단계

• Model providers 문서에서 제공자 규칙 확인하기
• 다른 모델 ID가 궁금하다면 Synthetic 공식 카탈로그 살펴보기

설정하다가 궁금한 점이 생기면 언제든 AI Setup Assistant에게 물어보세요!