Question 1

계정을 어떻게 가입하나요? 가입 후 해야 할 일은 무엇인가요?

Accepted Answer

가입 방법페이지 오른쪽 상단의 「가입」을 클릭하고 이메일 + 비밀번호를 사용하여 계정을 만들 수 있습니다(일부 환경에서는 이메일 인증 코드가 필요하니 가입 페이지의 실제 안내를 따르세요). 가입 전 《개인정보 처리방침》을 읽고 동의한 후 제출하세요.가입 후 해야 할 일로그인: 가입 후 이메일과 비밀번호로 로그인합니다.충전: 「콘솔」 페이지에서 충전하면 잔액으로 API를 호출할 수 있습니다.API Key 만들기: 「사용자 센터 → API 키」에서 sk-로 시작하는 키를 생성합니다.호출: 게이트웨이 주소를 이 사이트로 지정하고 API Key로 인증하면 Claude 모델을 호출할 수 있습니다.

Question 2

신규 사용자 가입 시 증정이 있나요?

Accepted Answer

네. 신규 사용자가 회원가입에 성공하면 체험 잔액 증정（기본적으로 ¥1 증정, 구체적인 내용은 사이트 내 설정을 따름）을 받을 수 있으며, 바로 API 호출 체험에 사용할 수 있습니다. 증정 잔액은 충전 잔액과 동일하게, token 사용량에 따라 실시간으로 차감되며, 「사용자 센터 → 잔액」에서 확인할 수 있습니다. 체험 잔액을 모두 사용한 후에도 계속 사용하려면 해당 요금제를 충전해 주세요.

Question 3

충전 방법은? 어떤 결제 수단을 지원하나요?

Accepted Answer

충전 방법계정에 로그인하여 '콘솔' 페이지로 이동합니다.충전 금액을 입력하고 '즉시 구매'를 클릭하여 주문합니다.결제 페이지 안내에 따라 결제를 완료합니다(알리페이, 실제 표시 기준).결제 성공 후 잔액은 실시간으로 입금되며, '콘솔 → 잔액'에서 확인할 수 있습니다.결제가 성공했지만 잔액이 입금되지 않은 경우, 결제 증빙 스크린샷을 보관하시고 고객 서비스에 문의해 주시면 신속히 확인하여 보상 처리해 드리겠습니다.

Question 4

어떤 충전 패키지가 있나요? 포인트 적립 규칙은 무엇인가요?

Accepted Answer

현재 다양한 충전 패키지가 제공되고 있습니다. 예시: 패키지충전 금액설명 ¥10 충전¥10기본 패키지 ¥50 충전¥50보너스 포인트 포함, 더 경제적임 고액 패키지는 더 많은 보너스 포인트를 제공합니다(예: ¥50 패키지 구매 시 30 포인트 증정). 패키지 명칭, 가격 및 적립 포인트는 「가격 정책」 페이지에 실시간으로 표시되는 기준을 따르며, 결제 전 내용을 반드시 확인하시기 바랍니다.

Question 5

잔액 과금 방식은 어떻게 되나요? 비용은 어떻게 계산되나요?

Accepted Answer

본 사이트는 토큰 사용량을 기준으로 과금하며, 호출 성공 시 실시간으로 차감됩니다. 단일 호출 비용 계산식은 다음과 같습니다: 비용 (원) = (입력 토큰 × 입력 단가 + 출력 토큰 × 출력 단가 + 캐시 적중 토큰 × 캐시 읽기 단가 + 캐시 저장 토큰 × 캐시 쓰기 단가) × 채널 배율 ÷ 1,000,000 단가: 각 모델마다 고유한 입력 / 출력 / 캐시 읽기 / 캐시 쓰기 단가(원 / 백만 토큰)가 적용되며, 「요금 안내」 페이지 또는 GET /api/v1/relay/models에서 확인 가능합니다. 배율: 채널이나 시간대에 따라 배율이 적용될 수 있으며, 현재 모든 모델의 기본 배율은 1.0(정가 과금)입니다. 캐시: 프롬프트 캐시에 적중된 토큰은 캐시 읽기 단가(입력 단가보다 훨씬 저렴)로 과금되며, 캐시에 저장되는 토큰은 캐시 쓰기 단가로 계산됩니다. 상세 내역: 각 호출의 토큰 사용량과 비용은 사용량 로그에 기록되며, 「사용자 센터 → API 사용량」에서 확인 및 대조할 수 있습니다.

Question 6

어떤 모델을 지원하며 가격은 어떻게 되나요?

Accepted Answer

현재 게이트웨이에서 개방 중인 모델:Claude / OpenAI / Gemini 등 주요 업체의 플래그십 모델 지원(단가 단위: 위안 / 백만 토큰, 캐시 쓰기 단가 및 실시간 배율은 GET /api/v1/relay/models 응답을 기준으로 합니다.)OpenAI / Gemini 등 모델 연동은 공식 문서 계획을 따르며, 실제 사용 가능한 모델은 GET /api/v1/relay/models 응답을 기준으로 합니다. 활성화되지 않은 모델을 호출할 경우 400 오류가 반환됩니다.

Question 7

API 키 생성 및 사용 방법

Accepted Answer

API 키 생성로그인 후 「콘솔 → API 키」에서 「생성」을 클릭합니다.시스템이 sk-xxxxxxxx 형식의 키를 생성하며, 생성 후 즉시 복사하여 저장하세요.키 목록에서 생성된 키를 확인/복사할 수 있습니다.API 키 사용API 호출 시 요청 헤더에 다음을 포함합니다: Authorization: Bearer sk-내 키 또는 x-api-key: sk-내 키.키는 계정 잔액과 연결되며, 키가 유효하지 않거나 비활성화되었거나 잔액이 부족하면 401 / 403이 반환됩니다.공개 저장소나 프론트엔드 코드에 키를 노출하지 마세요. 노출이 의심되면 즉시 비활성화하고 새로 생성하세요.

Question 8

API 호출 방법은 무엇인가요? 인증 헤더 및 요청 예시

Accepted Answer

API 주소 메서드경로설명 POST/api/v1/relay릴레이 전달 엔드포인트, 요청 본문은 Anthropic /v1/messages 페이로드 GET/api/v1/relay/models모델 및 단가 목록 (인증 불필요) GET / POST/api/v1/relay/keysAPI 키 관리 (로그인 필요) GET/api/v1/relay/usage사용량 상세 내역 (로그인 필요) curl 예시 curl -X POST http://127.0.0.1:8080/api/v1/relay \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-키를입력하세요" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "한 문장으로 자기소개를 해주세요"} ] }' 운영 환경에서는 127.0.0.1:8080을 실제 게이트웨이 도메인으로 교체하십시오. system 시스템 프롬프트, temperature 등의 매개변수도 포함할 수 있으며, 전체 필드 설명은 '사용 설명서'를 참조하십시오.

Question 9

스트리밍 출력을 지원하나요? 사용 방법은?

Accepted Answer

지원합니다. 요청 본문에 "stream": true를 추가하면 서버에서 SSE(Server-Sent Events) 방식을 통해 데이터를 청크 단위로 반환합니다. 이벤트 유형은 Anthropic과 동일합니다: event: message_start data: {"type": "message_start", "message": {"id": "msg_...", "model": "claude-sonnet-5"}} event: content_block_delta data: {"type": "content_block_delta", "delta": {"type": "text_delta", "text": "你好"}} event: message_delta data: {"type": "message_delta", "delta": {"stop_reason": "end_turn"}, "usage": {"output_tokens": 18}} event: message_stop data: {"type": "message_stop"} 클라이언트는 data: 행을 기준으로 JSON을 파싱하고, event: 행과 빈 줄은 무시하면 됩니다. message_stop을 수신하면 스트림이 종료된 것으로 간주합니다. 요금은 서버 측에서 전체 요청의 usage를 기준으로 산정되며, 스트리밍 여부와는 무관합니다.

Question 10

플랫폼 안정성은 어떻게 보장하나요? 상위 시스템 장애 시 어떻게 해야 하나요?

Accepted Answer

본 플랫폼은 다음과 같은 측면에서 안정성을 보장합니다: 다중 채널 재해 복구: 여러 상위 채널 설정을 지원하며 우선순위에 따라 자동으로 전환됩니다. 단일 채널에 이상 발생 시 예비 채널로 전환 가능합니다(운영 환경에서 주로 활성화). 에러 코드 정규화: 상위 시스템 이상 발생 시 명확한 HTTP 상태 코드(500 / 529 등)로 매핑되어 반환되므로 클라이언트 처리가 용이합니다. 호출 로그: 모든 호출 시 모델, 토큰, 비용 및 상태를 기록하여 문제 해결 및 정산이 간편합니다. 타임아웃 제어: 상위 요청에 타임아웃을 설정하여 장시간 대기 현상을 방지합니다. 호출 시 상위 시스템 오류(500 / 529)가 발생하면 잠시 후 재시도(지수 백오프 권장)하는 것을 권장합니다. 지속적으로 실패할 경우, request_id를 포함하여 고객 센터에 문의해 주시면 즉시 확인 후 채널을 전환해 드립니다.

Question 11

사용량 및 청구 내역을 확인하는 방법은 무엇인가요?

Accepted Answer

로그인 후 「콘솔 → 사용량 로그」에서 최근 호출 기록을 확인할 수 있으며, 각 항목은 다음 정보를 포함합니다.모델: 이번 호출에 사용된 모델 슬러그(slug)토큰: 입력 토큰, 출력 토큰, 캐시 읽기/캐시 쓰기 토큰비용: 이번 호출 시 차감된 금액(위안)상태: success(성공) 또는 no_quota(잔액 부족) 등호출 시 metadata.request_id를 통해 사용자 지정 요청 ID를 전달하면 사용량 로그에서 정확한 대조가 가능하므로 권장합니다.

Question 12

잔액이 부족하면 어떻게 되나요? 결제 규칙은 무엇인가요?

Accepted Answer

결제 규칙 호출이 성공하면 실제 토큰 사용량에 따라 실시간으로 차감됩니다 (공식은 '잔액 과금 방식' 참조). 차감은 서버 측에서 업스트림 요청을 완료하고 사용량을 확인한 후에 이루어지며, 금액은 센트(분) 단위까지 정밀하게 계산됩니다. 실패하거나 차단된 요청은 과금되지 않습니다. 잔액 부족 계정 잔액이 이번 호출 비용을 지불하기에 부족한 경우, 인터페이스는 403 잔액 부족, 충전이 필요합니다를 반환하며 이번 호출에 대해서는 요금이 부과되지 않습니다 (로그에 no_quota 기록이 남습니다). 충전이 완료되면 즉시 호출 기능을 복구할 수 있습니다. 온라인 서비스에 영향이 없도록 잔액을 확인하고 제때 충전하시길 권장합니다.

Question 13

쿠폰이나 초대 리베이트 이벤트가 있나요?

Accepted Answer

네, 플랫폼에서 두 가지 유형의 혜택을 제공합니다: 쿠폰 플랫폼은 금액 할인권 / 할인 쿠폰 / 포인트 적립 등 다양한 쿠폰 유형을 지원합니다. 쿠폰은 사이트 내 이벤트, 공지사항 및 고객센터를 통해 발급받을 수 있으며, 충전 시 사용 가능한 쿠폰이 있을 경우 선택하여 할인받을 수 있습니다. 친구 초대 리베이트 친구를 초대하여 가입 및 충전이 완료되면 일정 비율의 커미션 리베이트를 받을 수 있습니다. '사용자 센터 → 초대 / 커미션' 메뉴에서 초대 기록, 커미션 상세 내역 및 출금 신청을 할 수 있습니다. 구체적인 리베이트 비율은 초대 페이지 및 사이트 내 규정을 따릅니다.

Question 14

내 데이터는 안전한가요? 요청 내용이 저장되나요?

Accepted Answer

저희는 귀하의 데이터 보안을 매우 중요하게 생각합니다: 비밀번호: 암호화되어 저장되므로 플랫폼에서 평문을 확인할 수 없습니다. API Key: 귀하만 볼 수 있으며, 제3자에게 유출되지 않도록 안전하게 보관해 주십시오. 호출 로그: 모델, 토큰 사용량, 비용, 상태 등 과금 및 정산 정보만 기록하며, 대화 내용 자체는 저장하지 않습니다. 액세스 제어: 모든 인터페이스는 인증 과정을 거치며, 권한이 없는 요청은 귀하의 키를 사용할 수 없습니다. 또한, 요청 내용에 주민등록번호, 비밀번호, 결제 정보 등 민감한 개인정보를 제출하지 마십시오. 기업 기밀과 관련된 내용은 기업 자체 구축 환경에서 처리하시기 바랍니다. 자세한 내용은 《개인정보 처리방침》을 참조해 주십시오.

Question 15

환불 가능한가요? 환불 정책은 어떻게 되나요?

Accepted Answer

충전된 잔액은 API 호출 비용 결제에 사용되며, 일반적으로 단순 변심에 의한 환불은 지원하지 않습니다. 다음의 경우 고객센터로 문의하시면 처리해 드립니다. 결제는 완료되었으나 잔액이 충전되지 않은 경우 (중복 결제 / 결제 오류); 플랫폼 측 사유로 인해 장기간 서비스 이용이 불가능하고 복구가 어려운 경우; 기타 플랫폼의 책임으로 확인된 경우. 환불 신청 시 결제 증빙 스크린샷, 주문 번호, 계정 이메일을 함께 제공해 주시면 확인 후 신속하게 처리해 드리겠습니다. 악의적인 트래픽 발생이나 남용으로 인해 차단된 계정은 환불 대상에서 제외됩니다. 자세한 내용은 플랫폼의 최신 정책을 기준으로 합니다.

Question 16

문제가 발생했을 때 고객센터에 어떻게 연락하나요?

Accepted Answer

다음과 같은 방법으로 저희에게 문의하실 수 있습니다: 온라인 고객센터: 페이지 우측 하단의 고객센터 아이콘(위챗 / QQ / 이메일, 실제 페이지 표시 기준); 사이트 내 메시지: 로그인 후 사용자 센터에서 문제 피드백을 제출하실 수 있습니다. 보다 빠른 문제 해결을 위해 문의 시 아래 내용을 함께 제공해 주시기 바랍니다: 호출 시 전달한 request_id(metadata.request_id에 설정됨) 또는 호출 시간; API Key 앞자리, 오류 코드 및 반환된 메시지; 결제 관련 문의 시 주문 번호 및 결제 증빙 스크린샷을 첨부해 주세요. 고객센터 운영 시간은 09:00 – 22:00입니다. 운영 시간 외 남겨주신 메시지는 확인 후 최대한 빠르게 답변드리겠습니다.

Question 17

OpenAI / Gemini 호환 인터페이스를 지원하나요?

Accepted Answer

현재 게이트웨이는 Anthropic Messages API(/v1/messages) 호환 형식을 기본으로 하며, 진입점은 POST /api/v1/relay입니다: Anthropic 호환: ✅ 지원. 요청 본문 / 응답 구조 / 스트리밍 이벤트가 Anthropic과 동일하며, Claude Code나 Anthropic SDK 등은 Base URL만 변경하면 바로 연결 가능합니다. Gemini 호환: 공식 문서 계획에 따라(/v1beta/models/{model}:generateContent 등), 현재 환경은 실제 오픈되는 사양을 기준으로 합니다. OpenAI 호환: /v1/chat/completions 네이티브 엔드포인트는 아직 제공되지 않습니다. OpenAI 형식의 요청은 Anthropic messages 형식으로 변환한 후 호출해야 하며, 사용자 지정 Base URL을 지원하는 대부분의 통합 도구(one-api / new-api 등)를 통해 형식 변환이 가능합니다. 자세한 연결 방법은 '사용 문서'(Claude API 연결 가이드, Gemini API 연결 가이드)를 참조하십시오.