> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Together AI

[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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice together-api-key
    ```
  </Step>

  <Step title="기본 모델 설정">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: {
            primary: "together/meta-llama/Llama-3.3-70B-Instruct-Turbo",
          },
        },
      },
    }
    ```
  </Step>
</Steps>

### 비대화형 예시

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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>