자주 묻는 질문

Admesh.ai는 대규모 모델 통합 게이트웨이입니다. 이 서비스는 Claude, GPT, DeepSeek, Qwen, GLM, Kimi, Gemini, MiniMax 등 주요 모델들을 통일된 OpenAI 호환 인터페이스로 통합하여, 사용자는 기본 URL 하나와 API 키 하나만 있으면 이들 모델 간에 자유롭게 전환할 수 있습니다.

일반적으로 Base URL, API 키, 모델 이름 등 세 가지만 수정하면 됩니다. 기존 OpenAI SDK의 호출 방식, 메시지 구조, 스트리밍 처리 로직은 변경할 필요가 없습니다. Anthropic 네이티브 프로토콜을 사용 중이신 경우, 호환되는 엔드포인트도 제공합니다.

https://api.admesh.ai/v1. 모든 모델이 이 하나의 주소를 공유하며, 요청 본문의 model 필드를 통해 구체적인 모델을 선택합니다. 모델 이름 형식은 namespace/model이며, 예를 들어 anthropic/… 또는 openai/…와 같습니다.

Base URL을 사용자 정의할 수 있는 모든 OpenAI 호환 클라이언트(LangChain, LlamaIndex, Cursor, Cherry Studio, Claude Code, Codex CLI 등)를 사용할 수 있습니다. 문서 사이트에서는 각 클라이언트에 대한 단계별 연동 안내를 제공합니다.

콘솔의 모델 디렉터리 또는 공개된 /v1/models 인터페이스를 기준으로 하십시오. 해당 위치에는 현재 실제로 사용 가능한 모델 목록과 가격이 나와 있습니다. 코드 내에 모델 이름을 하드코딩하지 말고 구성 파일에 저장하여, 모델을 변경할 때는 구성만 수정하도록 하는 것이 좋습니다.

아닙니다. 재해 복구 전환은 동일한 public_model의 채널 풀 내에서만 이루어집니다. 즉, Claude를 요청하면 반환되는 결과는 반드시 Claude입니다. 모델 간 교체는 출력 품질에 직접적인 영향을 미치므로, 이는 게이트웨이가 대신 결정할 수 있는 사항이 아닙니다.

게이트웨이는 동일한 모델의 여러 채널 간에 자동으로 전환됩니다. 연결 실패, 타임아웃, 429, 5xx 오류가 발생하면 전환이 트리거되며, 연속 실패 횟수가 임계값에 도달하면 해당 채널은 서킷 브레이커 상태에 들어가 트래픽 수신을 일시 중지하고 주기적으로 복구 여부를 확인합니다.

순수하게 사용량에 따라 요금이 부과되며, 실제 토큰 사용량에 따라 정산됩니다. 월 이용료나 강제 구독은 없습니다. 충전 금액은 영구적으로 유효하며, 매월 초기화되지 않습니다. 자세한 내용은 가격 페이지에서 확인하세요.

상류 출력이 발생하지 않은 실패한 요청은 과금 대상에서 제외됩니다. 여기에는 매개변수 오류, 인증 실패, 잔액 부족 및 트래픽 제한이 포함됩니다. 스트리밍 응답에서 일부 내용이 이미 출력된 후 중단된 경우, 이미 생성된 출력에 대해서는 실제량에 따라 과금됩니다.

기본적으로 프롬프트와 모델 출력 본문은 저장되지 않습니다. 사용량 로그에는 요청 메타데이터, 토큰 수, 모델, 금액, 오류 코드 및 지연 시간만 기록되며, 이는 과금 및 문제 해결에 사용됩니다.

서버 측에서는 표시용으로 Key의 해시값과 접두사/마지막 네 자리만 저장하며, 평문은 생성 성공 시점에 한 번만 표시되고 그 이후에는 다시 읽을 수 없습니다. Key가 삭제되면 수십 초 이내에 무효화됩니다.

아닙니다. 업스트림 증빙 자료는 암호화된 저장소에만 보관되며, 로그나 브라우저 코드에 포함되지 않으며, 어떠한 대외 인터페이스에도 나타나지 않습니다.