---
read_when:
    - OpenClaw에서 Together AI를 사용하려는 경우
    - API 키 환경 변수 또는 CLI 인증 선택이 필요합니다
summary: Together AI 설정(인증 + 모델 선택)
title: Together AI
x-i18n:
    generated_at: "2026-06-27T18:04:46Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: a1f803ae88828a775d93dcf8b0b62e70b1dbd0cf963639121e2995fabfcd280b
    source_path: providers/together.md
    workflow: 16
---

[Together AI](https://together.ai)는 통합 API를 통해 Llama, DeepSeek, Kimi 등을 포함한 주요 오픈 소스 모델에 대한 액세스를 제공합니다.

| 속성 | 값                            |
| -------- | ----------------------------- |
| 공급자 | `together`                    |
| 인증     | `TOGETHER_API_KEY`            |
| API      | OpenAI 호환             |
| 기본 URL | `https://api.together.xyz/v1` |

## 시작하기

<Steps>
  <Step title="API 키 받기">
    [api.together.ai/settings/api-keys](https://api.together.ai/settings/api-keys)에서 API 키를 생성합니다.
  </Step>
  <Step title="온보딩 실행">
    ```bash
    openclaw onboard --auth-choice together-api-key
    ```
  </Step>
  <Step title="기본 모델 설정">
    ```json5
    {
      agents: {
        defaults: {
          model: {
            primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo",
          },
        },
      },
    }
    ```
  </Step>
</Steps>

### 비대화형 예시

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice together-api-key \
  --together-api-key "$TOGETHER_API_KEY"
```

<Note>
온보딩 프리셋은 `together/meta-llama/Llama-3.3-70B-Instruct-Turbo`를 기본 모델로 설정합니다.
</Note>

## 내장 카탈로그

OpenClaw는 이 번들 Together 카탈로그를 제공합니다.

| 모델 ref                                          | 이름                         | 입력       | 컨텍스트 | 비고                |
| -------------------------------------------------- | ---------------------------- | ----------- | ------- | -------------------- |
| `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | Llama 3.3 70B Instruct Turbo | 텍스트        | 131,072 | 기본 모델        |
| `together/moonshotai/Kimi-K2.6`                    | Kimi K2.6 FP4                | 텍스트, 이미지 | 262,144 | Kimi 추론 모델 |
| `together/deepseek-ai/DeepSeek-V4-Pro`             | DeepSeek V4 Pro              | 텍스트        | 512,000 | 추론 텍스트 모델 |
| `together/Qwen/Qwen2.5-7B-Instruct-Turbo`          | Qwen2.5 7B Instruct Turbo    | 텍스트        | 32,768  | 빠른 텍스트 모델      |
| `together/zai-org/GLM-5.1`                         | GLM 5.1 FP4                  | 텍스트        | 202,752 | 추론 텍스트 모델 |

## 비디오 생성

번들 `together` Plugin은 공유 `video_generate` 도구를 통한 비디오 생성도 등록합니다.

| 속성             | 값                                                                    |
| -------------------- | ------------------------------------------------------------------------ |
| 기본 비디오 모델  | `together/Wan-AI/Wan2.2-T2V-A14B`                                        |
| 모드                | 텍스트-비디오; `Wan-AI/Wan2.2-I2V-A14B`에서는 단일 이미지 참조만 |
| 지원되는 매개변수 | `aspectRatio`, `resolution`                                              |

Together를 기본 비디오 공급자로 사용하려면:

```json5
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "together/Wan-AI/Wan2.2-T2V-A14B",
      },
    },
  },
}
```

<Tip>
공유 도구 매개변수, 공급자 선택, 장애 조치 동작은 [비디오 생성](/ko/tools/video-generation)을 참조하세요.
</Tip>

<AccordionGroup>
  <Accordion title="환경 참고 사항">
    Gateway가 데몬(launchd/systemd)으로 실행되는 경우 해당 프로세스에서 `TOGETHER_API_KEY`를 사용할 수 있는지 확인하세요(예: `~/.openclaw/.env` 또는 `env.shellEnv`를 통해).

    <Warning>
    대화형 셸에서만 설정한 키는 데몬이 관리하는 Gateway 프로세스에 표시되지 않습니다. 지속적으로 사용할 수 있도록 `~/.openclaw/.env` 또는 `env.shellEnv` 구성을 사용하세요.
    </Warning>

  </Accordion>

  <Accordion title="문제 해결">
    - 키가 작동하는지 확인하세요: `openclaw models list --provider together`
    - 모델이 표시되지 않으면 Gateway 프로세스에 맞는 올바른 환경에 API 키가 설정되어 있는지 확인하세요.
    - 모델 ref는 `together/<model-id>` 형식을 사용합니다.

  </Accordion>
</AccordionGroup>

## 관련 항목

<CardGroup cols={2}>
  <Card title="모델 선택" href="/ko/concepts/model-providers" icon="layers">
    공급자 규칙, 모델 ref, 장애 조치 동작입니다.
  </Card>
  <Card title="비디오 생성" href="/ko/tools/video-generation" icon="video">
    공유 비디오 생성 도구 매개변수와 공급자 선택입니다.
  </Card>
  <Card title="구성 참조" href="/ko/gateway/configuration-reference" icon="gear">
    공급자 설정을 포함한 전체 구성 스키마입니다.
  </Card>
  <Card title="Together AI" href="https://together.ai" icon="arrow-up-right-from-square">
    Together AI 대시보드, API 문서, 가격 정보입니다.
  </Card>
</CardGroup>