설정 튜토리얼

3단계로 API Key 연결하기

클라이언트 설정과 계정 관리에 필요한 URL을 한곳에 모았습니다. 먼저 권장 Base URL을 사용하고, 클라이언트가 전체 엔드포인트나 Messages 호환 경로를 요구할 때만 해당 주소로 전환하세요.

첫 연결은 이 순서대로 진행하세요

먼저 모델과 요금을 선택하고 API Key를 발급받으세요. 다음으로 알맞은 URL을 복사한 뒤 클라이언트 하나를 설정하고 작은 테스트 요청을 보내세요.

  1. 01모델 선택 및 요금 확인

    클라이언트를 설정하기 전에 모델명, 컨텍스트 길이, 이미지 지원 여부와 배수를 확인하세요.

  2. 02API Key 준비

    신규 사용자: 먼저 API Key 구매

  3. 03올바른 URL 복사

    대부분의 OpenAI-compatible 클라이언트에서 사용합니다

  4. 04클라이언트 설정 입력

    응답이 정상적으로 반환되면 Base URL, API Key, 모델 라우팅과 네트워크 경로가 모두 올바르게 작동하는 것입니다.

01

API Key 준비

구매 후 발급받은 API Key 또는 잔여 한도가 있는 기존 API Key를 사용하고, 서버 측 환경 변수에 안전하게 저장하세요.

  • 신규 사용자: 먼저 API Key 구매
  • 기존 사용자: 같은 API Key에 한도 충전
  • 설정 완료 후: 잔여 한도와 요청 로그 확인
02

올바른 URL 복사

대부분의 OpenAI-compatible 클라이언트에는 /v1 로 끝나는 Base URL을 입력합니다. 클라이언트가 명시적으로 요구할 때만 전체 엔드포인트를 사용하세요.

권장 Base URL대부분의 OpenAI-compatible 클라이언트에서 사용합니다
https://new.weeanno.shop/v1
대체 Base URL클라이언트가 /v1 을 자동으로 추가할 때 사용합니다
https://new.weeanno.shop
Chat Completions 엔드포인트Chat Completions 호환 요청용 전체 URL
https://new.weeanno.shop/v1/chat/completions
Responses 엔드포인트Responses 호환 요청용 전체 URL
https://new.weeanno.shop/v1/responses
Messages 엔드포인트Messages 호환 클라이언트용 전체 URL
https://new.weeanno.shop/v1/messages
03

클라이언트 설정 입력

클라이언트의 해당 항목에 Base URL과 API Key를 입력하세요. 아래 예시에는 자리표시자만 포함되어 있습니다.

OpenAI-compatible 클라이언트

config
base_url = "https://new.weeanno.shop/v1"
api_key = "sk-your-api-key"

Claude Code · Messages 호환

config
export ANTHROPIC_BASE_URL="https://new.weeanno.shop"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

cURL로 테스트

응답이 정상적으로 반환되면 Base URL, API Key, 모델 라우팅과 네트워크 경로가 모두 올바르게 작동하는 것입니다.

bash
curl https://new.weeanno.shop/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

실제 API Key를 스크린샷, 채팅 메시지, 브라우저 측 코드 또는 공개 저장소에 붙여 넣지 마세요.

도구에 맞는 설정 선택

앱에서 요구하는 프로토콜에 맞춰 설정하세요. OpenAI-compatible 도구는 /v1 Base URL을 사용하고, Claude Code는 Messages-compatible 게이트웨이 URL을 사용합니다.

Cherry Studio · Chatbox · WorkBuddy

OpenAI-compatible 클라이언트

이 Base URL 입력

https://new.weeanno.shop/v1
설정 가이드 열기

Codex CLI · Cursor · VS Code · Trae · OpenCode

OpenAI-compatible 클라이언트

이 Base URL 입력

https://new.weeanno.shop/v1
설정 가이드 열기

OpenClaw · Hermes · Dify · n8n · LangChain · OpenWebUI

OpenAI-compatible 클라이언트

이 Base URL 입력

https://new.weeanno.shop/v1
설정 가이드 열기

자주 발생하는 오류 빠른 점검

모델이나 API Key를 변경하기 전에 먼저 HTTP 상태 코드를 확인하세요.

401 / 403
OpenAI 호환 클라이언트는 Authorization: Bearer <key>를 사용하고 Claude Code는 ANTHROPIC_AUTH_TOKEN을 사용합니다.
404
클라이언트에 Base URL과 전체 엔드포인트 중 무엇이 필요한지 확인하고 모델명도 검증하세요.
429
동시 요청 수를 줄이고 컨텍스트를 짧게 조정한 뒤 남은 Token 한도를 확인하세요.
TIMEOUT
작은 테스트 요청을 보내고 네트워크 경로를 확인한 다음 백오프를 적용해 재시도하세요.

WEE ANNO 지원팀에 문의하기 전에

전체 API Key를 노출하지 않으면서도 문제를 재현할 수 있도록 충분한 정보를 제공하세요.

  • 도구명과 버전
  • 모델명과 Base URL(API Key는 마스킹)
  • HTTP 상태 코드, 오류 메시지와 요청 ID
  • 대략적인 발생 시각과 시간대
WEE ANNO 지원팀에 문의

고객 포털 URL

구매, 충전, 주문 상태, Token 잔여 한도와 전체 개발자 문서는 아래 공개 URL에서 확인할 수 있습니다.

웹사이트 입구WEE ANNO 홈페이지와 주요 메뉴
https://weeanno.shop/ko
구매새 API Key를 구매하고 발급받기
https://weeanno.shop/ko/buy
충전기존 API Key에 사용 한도 추가하기
https://weeanno.shop/ko/topup
주문 조회결제와 한도 반영 상태 확인하기
https://weeanno.shop/ko/topup/query
Token 한도 조회잔여 한도와 요청 로그 확인하기
https://weeanno.shop/ko/quota
개발자 문서SDK, 스트리밍, 오류와 사용량 제한 확인하기
https://weeanno.shop/ko/docs