Together AI Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Together AI
개요
이 페이지는 OpenClaw Together AI provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Together AI setup (auth + model selection)
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider | together |
| Auth | TOGETHER_API_KEY |
| API | OpenAI-compatible |
| Base URL | https://api.together.xyz/v1 |
공식 문서 기반 상세
아래는 공식 providers/together 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Together AI provides access to leading open-source
models including Llama, DeepSeek, Kimi, and more through a unified API.
OpenClaw bundles it as the together provider.
| Property | Value |
|---|---|
| Provider | together |
| Auth | TOGETHER_API_KEY |
| API | OpenAI-compatible |
| Base URL | https://api.together.xyz/v1 |
시작하기
Get an API key
Create an API key at
[api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys).
Run onboarding
```bash
openclaw onboard --auth-choice together-api-key
```
Set a default model
```json5
{
agents: {
defaults: {
model: {
primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo",
},
},
},
}
```
Non-interactive example
openclaw onboard --non-interactive \
--mode local \
--auth-choice together-api-key \
--together-api-key "$TOGETHER_API_KEY"
Onboarding sets
together/meta-llama/Llama-3.3-70B-Instruct-Turboas the default model.
Built-in catalog
Cost is USD per million tokens.
| Model ref | Name | Input | Context | Max output | Cost (in/out) | Notes |
|---|---|---|---|---|---|---|
together/meta-llama/Llama-3.3-70B-Instruct-Turbo |
Llama 3.3 70B Instruct Turbo | text | 131,072 | 8,192 | 0.88 / 0.88 | Default model |
together/moonshotai/Kimi-K2.6 |
Kimi K2.6 FP4 | text, image | 262,144 | 32,768 | 1.20 / 4.50 | Reasoning model |
together/deepseek-ai/DeepSeek-V4-Pro |
DeepSeek V4 Pro | text | 512,000 | 8,192 | 2.10 / 4.40 | Reasoning model |
together/Qwen/Qwen2.5-7B-Instruct-Turbo |
Qwen2.5 7B Instruct Turbo | text | 32,768 | 8,192 | 0.30 / 0.30 | Fast, non-reasoning |
together/zai-org/GLM-5.1 |
GLM 5.1 FP4 | text | 202,752 | 8,192 | 1.40 / 4.40 | Reasoning model |
비디오 생성
The bundled together plugin also registers video generation through the
shared video_generate tool.
| Property | Value |
|---|---|
| Default video model | Wan-AI/Wan2.2-T2V-A14B |
| Other models | Wan-AI/Wan2.2-I2V-A14B, minimax/hailuo-02, kwaivgI/kling-2.1-master |
| Modes | text-to-video; image-to-video only with Wan-AI/Wan2.2-I2V-A14B (single reference image) |
| Duration | 1-10 seconds |
| Supported parameters | size (parsed as <width>x<height>); aspectRatio/resolution are not read |
To use Together as the default video provider:
{
agents: {
defaults: {
videoGenerationModel: {
primary: "together/Wan-AI/Wan2.2-T2V-A14B",
},
},
},
}
See Video generation for the shared tool parameters, provider selection, and failover behavior.
Environment note
If the Gateway runs as a daemon (launchd/systemd), make sure
`TOGETHER_API_KEY` is available to that process (for example, in
`~/.openclaw/.env` or via `env.shellEnv`).
Keys set only in your interactive shell are not visible to daemon-managed gateway processes. Use
~/.openclaw/.envorenv.shellEnvconfig for persistent availability.
문제 해결
- Verify your key works: `openclaw models list --provider together`
- If models are not appearing, confirm the API key is set in the correct
environment for your Gateway process.
- Model refs use the form `together/<model-id>`.
관련 문서
Provider rules, model refs, and failover behavior.
Shared video generation tool parameters and provider selection.
Full config schema including provider settings.
Together AI dashboard, API docs, and pricing.
검증 체크리스트
-
openclaw models list --provider together로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토