한 줄만 바꾸면 이전 완료
OpenAI의 요청·응답 구조를 그대로 씁니다. openai-python과 openai-node는 물론, OpenAI 프로토콜을 따르는 SDK와 프레임워크, 에이전트 클라이언트도 바로 이쪽으로 연결하면 되고 기존 코드는 손대지 않아도 됩니다.
OPENAI 호환 · 사용량 기반 과금 · 월 요금 없음
누구나 부담 없이 쓰는 LLM API
기간 한정으로 1달러를 충전하면 20달러 크레딧을 드립니다(기간이 끝나면 1:10로 돌아갑니다). 토큰 단위 사용량 기반 과금이라 월 요금도, 최소 사용 금액도 없습니다. base_url 한 줄만 바꾸면 DeepSeek, Qwen, MiniMax, Xiaomi(샤오미) 등 16+개 모델을 쓸 수 있습니다.
Google / GitHub 원클릭 로그인 · 카드 등록 불필요 · 가입만 해도 1달러 크레딧
base_url = "https://api.y-api.bestvirtualgoods.com/v1"
api_key = "sk-..."
model = "deepseek/deepseek-v4-pro"- 기간 한정 충전·크레딧 비율
- 1 : 20
- 호출할 수 있는 모델
- 16+개
- OpenAI 호환
- 수정 없음
- 요청·응답 내용
- 저장 안 함
왜 Y-API인가
비용과 이전 부담을 한 번에 해결
요청 내용은 저장하지 않습니다
보내신 프롬프트와 모델이 돌려준 내용은 저장하지 않습니다. 요청 로그에는 시각, 모델, 토큰 수, 차감된 크레딧만 남고 용도는 사용 내역 대조뿐입니다.
기간 한정, 1달러 충전으로 20달러 크레딧
지금은 기간 한정 1:20이고, 기간이 끝나면 1:10로 돌아갑니다. 크레딧은 실제 토큰 사용량만큼 차감되며 금액이 얼마든 같은 비율로 환산됩니다. 월 요금도, 구독 조건도, 최소 사용 금액도 없어서 호출하지 않으면 비용이 발생하지 않습니다.
크레딧은 하나, 키는 여러 개
같은 계정의 키는 하나의 잔액을 공유합니다. 프로젝트별, 환경별로 나눠 관리할 수 있고 어느 키든 언제든 추가하거나 폐기할 수 있으며 다른 키에는 영향이 없습니다.
모든 호출에 내역이 남습니다
콘솔 요청 로그에 호출별 시각, 모델, 토큰 수, 사용한 크레딧, 소요 시간이 나열됩니다. 개요 페이지에서는 최근 30일 사용량을 모델별로 집계합니다.
비밀번호를 저장하지 않습니다
로그인은 Google과 GitHub만 지원합니다. 비밀번호를 아예 저장하지 않으므로 유출이나 재설정 절차를 노리는 공격 표면 자체가 없습니다.
이전 비용
한 번의 수정, 두 줄의 코드
이미 OpenAI 공식 SDK를 쓰고 계시다면 base_url과 api_key만 바꾸면 이전은 끝입니다. model에는 목록에 있는 아무 ID나 넣으면 됩니다.
from openai import OpenAI client = OpenAI(- base_url="https://api.openai.com/v1",- api_key=os.environ["OPENAI_API_KEY"],+ base_url="https://api.y-api.bestvirtualgoods.com/v1",+ api_key=os.environ["YAPI_KEY"], )3단계
로그인부터 첫 호출까지
01
로그인
Google 또는 GitHub으로 로그인하세요. 계정이 자동으로 개설되고 1달러 크레딧이 함께 지급됩니다. 작성할 양식은 하나도 없습니다.
02
키 받기
개설할 때 기본 키 하나가 이미 만들어져 있습니다. 콘솔의 ‘API 키’ 페이지에서 원문을 확인할 수 있고, 프로젝트별로 더 만들 수도 있습니다.
03
base_url 변경
SDK의 base_url을 Y-API로 돌리고 model에 목록의 ID를 넣으면 바로 호출할 수 있습니다.
지원 모델
16+개 모델을 하나의 API로
모두 같은 base_url과 같은 키로 호출합니다. 모델 전환은 model 필드만 바꾸면 됩니다. 아래는 제공업체별 대표 모델입니다.
| 모델 ID | 입력 / 100만 토큰 | 출력 / 100만 토큰 |
|---|---|---|
| DeepSeek | ||
| deepseek/deepseek-v3.2 | $1.00 | $1.00 |
| 通义千问 Qwen | ||
| qwen/qwen3.8-max | $2.00 | $6.00 |
| MiniMax | ||
| minimax/minimax-m2.5-highspeed | $0.60 | $2.40 |
| 其他 | ||
| stealth/ox-alpha | $1.00 | $5.00 |
요금과 과금
1달러를 충전하면 계정에 20달러 크레딧
크레딧은 토큰 사용량만큼 차감되고 그 양은 모델에 따라 달라집니다. 저렴한 모델은 오래 쓸 수 있고 대표 모델은 더 빠르게 소모됩니다. 호출별 실제 차감액은 콘솔 요청 로그에서 확인할 수 있습니다.
| 결제 금액 | 지급 크레딧 |
|---|---|
| $5 | $100 |
| $10 | $200 |
| $50 | $1,000 |
| $100 | $2,000 |
요금제 등급이 아닙니다. 금액 기준선도 없어서 얼마를 넣어도 같은 비율로 환산됩니다.
어디에 맞는가
이런 경우에 차이가 가장 큽니다
개인 프로젝트와 사이드 프로덕트
아직 수익이 없는 데모가 월 요금부터 짊어질 이유는 없습니다. 쓴 만큼만 내고, 개발을 멈추면 비용도 발생하지 않습니다.
에이전트와 배치 작업
여러 차례의 도구 호출, 긴 컨텍스트, 배치 처리에서는 토큰 소모가 몇 배로 불어나고 단가 차이가 그대로 청구액 차이가 됩니다.
사내 도구
환경별로 다른 키를 나눠 주면서 잔액은 하나로 공유합니다. 누가 언제 어떤 모델을 호출했는지는 로그에서 맞춰 볼 수 있습니다.
공식 API에서 이전
기존 코드가 OpenAI SDK 기준으로 작성되어 있고, 공급처를 바꾸려고 호출 계층을 다시 쓰고 싶지는 않은 경우입니다.
먼저 말씀드립니다
분명히 밝혀 둘 것들
‘1달러가 20달러로’는 기간 한정 크레딧이며 할인 쿠폰이 아닙니다
지금은 기간 한정 혜택으로, 1달러를 결제하면 계정 크레딧이 20달러 늘어납니다(기간 종료 후에는 1:10). 크레딧은 모델별 배율로 차감되고 그 속도는 모델마다 크게 다릅니다. 그래서 ‘공식 가격의 5%로 쓸 수 있다’는 뜻은 아닙니다. 실제 비용은 요청 로그의 차감액을 기준으로 봐 주세요.
요청 내용을 저장하지 않습니다
보내신 프롬프트와 모델이 돌려준 내용은 저장하지 않습니다. 콘솔에 보이는 로그에는 호출 메타데이터(시각, 모델, 토큰 수, 소요 시간, 차감 크레딧)만 담기고, 사용 내역 대조에 씁니다.
키는 언제든 폐기할 수 있습니다
키 원문은 ‘보기’를 눌렀을 때만 돌려주고 목록에 계속 드러내지 않습니다. 삭제하면 그 키로 보낸 호출은 즉시 실패하고 다른 키에는 영향이 없습니다.
자주 묻는 질문
이런 점도 궁금하실 수 있습니다
- Y-API는 무엇인가요?
- Y-API는 OpenAI 호환 LLM API 서비스입니다. 하나의 엔드포인트와 키를 제공해 같은 코드로 DeepSeek, Qwen, MiniMax, Xiaomi(샤오미) 등 16+개 모델을 호출할 수 있습니다. 과금은 토큰 사용량 기준이고 월 요금은 없습니다.
- Y-API는 OpenAI 공식 API와 호환되나요?
- 호환됩니다. Y-API는 OpenAI와 같은 요청·응답 구조를 씁니다. SDK의 base_url을 Y-API 엔드포인트로, api_key를 Y-API가 발급한 키로 바꾸면 되고 나머지 코드는 그대로 둡니다.
- Y-API는 어떤 모델을 지원하나요?
- Y-API는 현재 16+개 모델을 지원하며 DeepSeek, Qwen, MiniMax, Xiaomi(샤오미) 등의 제공업체를 아우릅니다. 전체 모델 ID 목록은 Y-API 모델 목록 페이지(https://y-api.bestvirtualgoods.com/models)에 있습니다. 호출할 때 요청의 model 필드에 그 ID를 넣으면 됩니다.
- Y-API 과금은 어떻게 계산되나요?
- 토큰 사용량만큼 계정 크레딧에서 차감합니다. 차감량은 호출한 모델의 배율로 정해지고 입력과 출력은 따로 계산합니다. 월 요금도, 구독 조건도, 최소 사용 금액도 없어서 호출하지 않으면 비용이 발생하지 않습니다.
- ‘1달러 충전으로 20달러 크레딧’은 무슨 뜻인가요?
- 현재 기간 한정 혜택입니다. 1달러를 충전할 때마다 계정 크레딧이 20달러 늘어납니다(기간 종료 후에는 1:10). 크레딧은 서비스 안의 과금 단위이고 토큰 사용량만큼 차감됩니다. 차감 속도가 모델마다 다르므로 공식 가격에 대한 고정 할인율과 같은 뜻은 아닙니다.
- Y-API에 월 요금이나 최소 사용 금액이 있나요?
- 없습니다. Y-API는 실제 토큰 사용량만큼 크레딧을 차감할 뿐입니다. 월 요금도, 구독 조건도, 최소 사용 금액도 없고 계정을 쓰지 않고 두어도 비용이 생기지 않습니다.
- API 키를 여러 개 만들 수 있나요? 크레딧은 나뉘나요?
- 여러 개 만들 수 있습니다. 모든 키가 같은 계정 잔액을 공유하고 키별로 따로 배분하지 않습니다. 프로젝트별, 환경별 관리에 알맞고 어느 키든 언제든 폐기할 수 있으며 다른 키에는 영향이 없습니다.
- Y-API는 스트리밍을 지원하나요?
- 지원합니다. 요청에 stream 파라미터를 추가하면 OpenAI와 같은 형식의 SSE 청크가 돌아옵니다. 클라이언트에서 따로 처리할 것은 없습니다.
- 호출 기록을 볼 수 있나요?
- 볼 수 있습니다. 콘솔 요청 로그에 호출별 시각, 모델, 키, 토큰 수, 사용한 크레딧, 소요 시간이 나열됩니다. 개요 페이지에서는 최근 30일 사용량과 요청 수를 모델별로 집계합니다.
- Y-API가 제가 보낸 내용을 볼 수 있나요?
- 볼 수 없습니다. Y-API는 요청과 응답 내용을 저장하지 않습니다. 콘솔에 표시되는 로그에는 호출 메타데이터(시각, 모델, 토큰 수, 소요 시간, 차감 크레딧)만 담기고 프롬프트나 응답 본문은 담기지 않습니다.
- 크레딧을 다 쓰면 어떻게 되나요?
- API가 HTTP 429를 반환하고 요청은 실행되지 않습니다. https://y-api.bestvirtualgoods.com/app/billing에서 충전하면 크레딧이 바로 반영되고, 키는 그대로 유효하며 코드도 고칠 필요가 없습니다.
- 가입할 때 신용카드가 필요한가요?
- 필요하지 않습니다. Google 또는 GitHub으로 로그인하면 계정이 자동으로 개설되고 1달러 크레딧이 지급됩니다. 체험 단계에서 결제 정보를 입력하는 일은 없습니다.