Synthetic Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Synthetic
개요
이 페이지는 OpenClaw Synthetic provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Use Synthetic's Anthropic-compatible API in OpenClaw
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider | synthetic |
| Auth | SYNTHETIC_API_KEY |
| API | Anthropic Messages |
| Base URL | https://api.synthetic.new/anthropic |
공식 문서 기반 상세
아래는 공식 providers/synthetic 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Synthetic exposes Anthropic-compatible endpoints.
OpenClaw bundles it as the synthetic provider and uses the Anthropic
Messages API.
| Property | Value |
|---|---|
| Provider | synthetic |
| Auth | SYNTHETIC_API_KEY |
| API | Anthropic Messages |
| Base URL | https://api.synthetic.new/anthropic |
시작하기
Get an API key
Get a `SYNTHETIC_API_KEY` from your Synthetic account, or let onboarding
prompt you for one.
Run onboarding
```bash
openclaw onboard --auth-choice synthetic-api-key
```
Verify the default model
Onboarding sets the default model to:
```text
synthetic/hf:MiniMaxAI/MiniMax-M3
```
OpenClaw's Anthropic client appends
/v1to the base URL automatically, so usehttps://api.synthetic.new/anthropic(not/anthropic/v1). If Synthetic changes its base URL, overridemodels.providers.synthetic.baseUrl.
설정 예시
{
env: { SYNTHETIC_API_KEY: "sk-..." },
agents: {
defaults: {
model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" },
models: { "synthetic/hf:MiniMaxAI/MiniMax-M3": { alias: "MiniMax M3" } },
},
},
models: {
mode: "merge",
providers: {
synthetic: {
baseUrl: "https://api.synthetic.new/anthropic",
apiKey: "${SYNTHETIC_API_KEY}",
api: "anthropic-messages",
models: [
{
id: "hf:MiniMaxAI/MiniMax-M3",
name: "MiniMax M3",
reasoning: true,
input: ["text", "image"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 262144,
maxTokens: 65536,
},
],
},
},
},
}
Built-in catalog
All Synthetic models use cost 0 (input/output/cache). See Synthetic's
current model list for service availability.
| Model ID | Context window | Max tokens | Reasoning | Input |
|---|---|---|---|---|
hf:MiniMaxAI/MiniMax-M3 |
262,144 | 65,536 | yes | text + image |
hf:moonshotai/Kimi-K2.7-Code |
262,144 | 8,192 | yes | text + image |
hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4 |
262,144 | 8,192 | yes | text |
hf:openai/gpt-oss-120b |
131,072 | 8,192 | yes | text |
hf:Qwen/Qwen3.6-27B |
262,144 | 81,920 | yes | text + image |
hf:zai-org/GLM-4.7-Flash |
196,608 | 131,072 | yes | text |
hf:zai-org/GLM-5.2 |
524,288 | 131,072 | yes | text |
Model refs use the form
synthetic/<modelId>. Useopenclaw models list --provider syntheticto see all models available on your account.
Model allowlist
If you enable a model allowlist (`agents.defaults.modelPolicy.allow`), add every
Synthetic model you plan to use. Models not in the allowlist are hidden
from the agent.
Base URL override
If Synthetic changes its API endpoint, override the base URL:
```json5
{
models: {
providers: {
synthetic: {
baseUrl: "https://new-api.synthetic.new/anthropic",
},
},
},
}
```
OpenClaw still appends `/v1` automatically.
관련 문서
Provider rules, model refs, and failover behavior.
Full config schema including provider settings.
Synthetic dashboard and API docs.
검증 체크리스트
-
openclaw models list --provider synthetic로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토