APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

TRAE API 키 설정 — Agent 타사 키 구성 가이드

APIMaster.ai를 TRAE IDE Agent에서 타사 API로 구성하세요. 사용자 정의 OpenAI Chat Completions 설정(기본 URL 및 모델 ID)을 사용하여 GPT, Claude, DeepSeek 등을 연결하세요.

TRAE IDE (ByteDance의 AI 네이티브 코딩 IDE)에는 작업을 이해하고 작업을 계획하며 코드를 자율적으로 편집하는 Agent 모드가 포함되어 있습니다. TRAE는 타사 API 키를 통해 사용자 정의 모델을 지원합니다. APIMaster.ai는 OpenAI Chat Completions 호환 엔드포인트를 제공합니다. TRAE에서 사용자 정의 모델을 추가하여 연결하세요.

먼저 API 키 받기를 진행하세요. 키는 사용자 기기에만 저장됩니다. 요청이 실패하면 연결 테스트를 사용하세요.

필수 조건

  1. TRAE IDE 설치 (trae.ai 또는 trae.cn)
  2. 콘솔에서 APIMaster API 키
  3. 마켓플레이스의 대상 모델 ID (예: gpt-5.5, claude-sonnet-4-6, deepseek-v4-pro)

1단계 — Agent 열고 모델 추가

  1. TRAE IDE를 열고 Agent 채팅(입력창에서 @Agent)으로 이동합니다.
  2. 오른쪽 하단의 모델 선택기(현재 모델 이름 옆 드롭다운)를 클릭합니다.
  3. 메뉴 하단에서 모델 추가(添加模型)를 클릭합니다.

TRAE Agent — 모델 추가 클릭

2단계 — 사용자 정의 구성

모델 편집 대화상자에서 사용자 정의 구성(自定义配置) 탭을 열고 다음을 입력합니다:

필드 값
API 형식 OpenAI Chat Completions
사용자 정의 요청 URL https://apimaster.ai/v1 (끝에 슬래시 없음)
전체 URL 끔 (TRAE가 자동으로 /chat/completions를 추가)
모델 ID 마켓플레이스 모델 ID, 예: gpt-5.5, claude-sonnet-4-6
멀티모달 모델이 이미지를 지원하면 켬, 텍스트 전용이면 끔
API 키 사용자의 APIMaster 키

TRAE 모델 편집 — APIMaster 사용자 정의 구성

참고:

  • OpenAI 호환 엔드포인트 사용: https://apimaster.ai/v1. TRAE가 경로에 /chat/completions를 추가합니다.
  • 모델 ID는 마켓플레이스 ID와 정확히 일치해야 합니다.
  • 확인(确认)을 클릭하여 저장합니다.

3단계 — 사용자 정의 모델 선택

  1. 모델 선택기를 다시 엽니다.
  2. 사용자 정의 모델(自定义模型) 아래에서 추가한 모델(예: gpt-5.5)을 선택합니다.
  3. 하단 바에 모델 ID가 표시됩니다.

TRAE 모델 선택기 — 사용자 정의 모델 활성화

4단계 — Agent 채팅 테스트

  1. Agent에서 테스트 메시지(예: hi 또는 작은 코딩 작업)를 보냅니다.
  2. 정상적인 응답이 오면 설정이 작동하는 것입니다.
  3. TRAE가 제공자 **custom_openai_compatible**를 표시하면 요청이 OpenAI 호환 프로토콜을 통해 APIMaster를 거쳐 전송되는 것입니다.

TRAE Agent 채팅 — custom_openai_compatible 제공자

예시 모델 ID

모델 ID 참고
gpt-5.4 / gpt-5.5 GPT
claude-haiku-4-5 Claude Haiku
claude-sonnet-4-6 Claude Sonnet
claude-opus-4-7 / claude-opus-4-8 Claude Opus
deepseek-v4-pro / deepseek-v4-flash DeepSeek
gemini-2.5-pro / gemini-2.5-flash Gemini

마켓플레이스에서 ID를 복사하세요. 별칭을 추측하지 마세요.

문제 해결

문제 해결 방법
401 / 잘못된 API 키 키를 다시 붙여넣고 콘솔에서 활성 상태인지 확인
404 / 모델을 찾을 수 없음 마켓플레이스에서 모델 ID를 다시 복사
시간 초과 URL은 https://apimaster.ai/v1이어야 함 (끝에 슬래시 없음); 네트워크/프록시 확인
모델 추가 버튼 없음 빌더 사이드바가 아닌 Agent 채팅 모델 선택기(오른쪽 하단) 사용
여전히 내장 모델 사용 중 사용자 정의 모델에서 항목 선택
멀티모달 오류 모델이 텍스트 전용인 경우 멀티모달 끄기

체크리스트

  • Agent 모델 선택기 열기 → 모델 추가
  • API 형식 = OpenAI Chat Completions
  • 사용자 정의 요청 URL = https://apimaster.ai/v1 (전체 URL 끔)
  • 마켓플레이스의 모델 ID
  • API 키 = APIMaster 키
  • 사용자 정의 모델 선택; Agent가 성공적으로 응답

관련 링크