Providers

Together AI

Together AI는 통합 API를 통해 Llama, DeepSeek, Kimi 등 주요 오픈 소스 모델에 대한 액세스를 제공합니다.

속성
Provider together
인증 TOGETHER_API_KEY
API OpenAI 호환
기본 URL https://api.together.xyz/v1

시작하기

  • API 키 받기

    api.together.ai/settings/api-keys에서 API 키를 생성합니다.

  • 온보딩 실행

    openclaw onboard --auth-choice together-api-key
    
  • 기본 모델 설정

    {
      agents: {
        defaults: {
          model: { primary: "together/moonshotai/Kimi-K2.5" },
        },
      },
    }
    
  • 비대화형 예시

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

    기본 제공 카탈로그

    OpenClaw에는 다음 Together 카탈로그가 번들로 제공됩니다.

    모델 참조 이름 입력 컨텍스트 참고 사항
    together/moonshotai/Kimi-K2.5 Kimi K2.5 텍스트, 이미지 262,144 기본 모델; 추론 활성화
    together/zai-org/GLM-4.7 GLM 4.7 Fp8 텍스트 202,752 범용 텍스트 모델
    together/meta-llama/Llama-3.3-70B-Instruct-Turbo Llama 3.3 70B Instruct Turbo 텍스트 131,072 빠른 지시 모델
    together/meta-llama/Llama-4-Scout-17B-16E-Instruct Llama 4 Scout 17B 16E Instruct 텍스트, 이미지 10,000,000 멀티모달
    together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 Llama 4 Maverick 17B 128E Instruct FP8 텍스트, 이미지 20,000,000 멀티모달
    together/deepseek-ai/DeepSeek-V3.1 DeepSeek V3.1 텍스트 131,072 범용 텍스트 모델
    together/deepseek-ai/DeepSeek-R1 DeepSeek R1 텍스트 131,072 추론 모델
    together/moonshotai/Kimi-K2-Instruct-0905 Kimi K2-Instruct 0905 텍스트 262,144 보조 Kimi 텍스트 모델

    동영상 생성

    번들로 제공되는 together Plugin은 공유 video_generate 도구를 통한 동영상 생성도 등록합니다.

    속성
    기본 동영상 모델 together/Wan-AI/Wan2.2-T2V-A14B
    모드 텍스트-동영상, 단일 이미지 참조
    지원되는 매개변수 aspectRatio, resolution

    Together를 기본 동영상 Provider로 사용하려면 다음과 같이 설정합니다.

    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "together/Wan-AI/Wan2.2-T2V-A14B",
          },
        },
      },
    }
    
    환경 참고 사항

    Gateway가 데몬(launchd/systemd)으로 실행되는 경우 해당 프로세스에서 TOGETHER_API_KEY를 사용할 수 있는지 확인하세요(예: ~/.openclaw/.env 또는 env.shellEnv를 통해).

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

    관련 항목