상태 · 헬스 체크와 장애

LLMwithCrypto API가 작동하나요?

여기서 믿을 만한 상태 번호는 없습니다. 대신 1초 만에 직접 실행할 수 있는 확인 방법이 있습니다. 이 페이지는 그 방법을 보여주고, 어떤 오류가 저희 쪽 문제이고 어떤 것이 사용자 쪽 문제인지, 앱이 각 오류에 어떻게 반응해야 하는지 설명합니다.

마지막 업데이트: 2026년 10월 23일

빠른 답변

LLMwithCrypto이 작동하는지 어떻게 확인하나요?

API 키로 GET https://llmwithcrypto.com/api/v1/credits을 호출하세요. 토큰을 생성하지 않으므로 비용이 들지 않으며, 정상적인 JSON 응답이면 LLMwithCrypto API, API 키, 계정이 모두 작동한다는 뜻입니다. 그다음 사용 중인 모델로 짧은 채팅 완성을 하나 보내세요. 2026년 10월 23일 기준 저희 가격으로는 대부분의 모델에서 1센트의 일부만 듭니다. 서버 오류는 청구되지 않으며, 장애는 체인지로그에 날짜가 기록됩니다.

가장 빠른 상태 확인 방법은 무엇인가요?

두 번의 호출을 다음 순서로 하세요:

GET https://llmwithcrypto.com/api/v1/credits — 저희 측에서만 답합니다: 인증, API, 계정 상태입니다. 남은 크레딧이 담긴 응답이 오면 귀하에게 서비스가 정상이라는 뜻입니다.
GET https://llmwithcrypto.com/api/v1/models — 귀하의 키로 호출할 수 있는 모델 목록을 보여줍니다. 사용하는 모델이 없으면 지원팀이 확인하는 동안 모델 페이지에서 다른 모델을 고르세요.

둘 중 하나라도 401를 반환하면 키가 틀렸거나 폐기된 것입니다. 대시보드에서 새 키를 만드세요.

curl: 남은 크레딧과 모델 목록 (토큰 사용 없음)

curl -s https://llmwithcrypto.com/api/v1/credits \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"

curl -s https://llmwithcrypto.com/api/v1/models \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY"

Python: 사용하는 모델을 토큰 하나로 확인

import os
import sys

from openai import OpenAI

client = OpenAI(base_url="https://llmwithcrypto.com/api/v1", api_key=os.environ["LLMWITHCRYPTO_API_KEY"])
try:
    client.chat.completions.create(
        model="gpt-oss-20b",
        messages=[{"role": "user", "content": "ping"}],
        max_tokens=1,
    )
except Exception as exc:
    print("model check failed:", exc)
    sys.exit(1)
print("model answers")

저희 오류와 제 요청 오류를 어떻게 구분하나요?

OpenAI의 API와 마찬가지로 상태 코드 계열로 구분합니다:

4xx — 요청이나 계정의 문제입니다: 잘못된 키, 크레딧 소진, 알 수 없는 모델 id, 모델이 받지 않는 parameter, 또는 분당 요청 수 초과입니다. 요청을 고치세요. 같은 요청을 다시 보내면 rate limit을 제외하고 또 실패합니다.
5xx — 저희 측 또는 모델 서버의 문제입니다. 잔액에서 토큰 단위로 결제합니다. 입력 및 출력 토큰은 모델 자체의 tokenizer로 계산되며, 해당 모델의 1M 토큰당 가격으로 청구됩니다. 오류로 끝난 호출은 비용이 들지 않습니다.

errors 페이지에 모든 코드와 그 의미가 나와 있습니다.

호출이 실패하면 제 앱은 어떻게 해야 하나요?

Rate limit: 기다렸다가 지연 시간을 늘려가며 재시도하세요. 모든 계정에는 분당 요청 및 토큰 한도가 있으며 대시보드에 표시됩니다. 지원팀에 요청하면 한도를 올릴 수 있습니다.
서버 오류 또는 타임아웃: 백오프를 두고 한두 번 재시도하세요. 같은 모델이 계속 실패하면 비슷한 특성의 다른 모델로 바꾸세요. 하나의 키로 모든 모델을 호출할 수 있습니다.
크레딧 소진: 충전하고 pack을 구매하세요. 크레딧이 계정에 들어오면 호출이 다시 됩니다.
인증 오류: 무엇보다 먼저 환경 변수의 키를 확인하세요.

장애 기록은 어디에 있나요?

changelog에 날짜, 영향을 받은 모델, 조치 내용과 함께 기록됩니다. 가격, 모델 추가 및 제거도 여기에 올라갑니다. 귀하의 계정에만 영향을 준 장애는 UTC 시각과 가능하면 request id를 적어 [email protected]으로 보내 주세요.

상태 관련 질문

크레딧 확인은 무료인가요?

예. 모델을 실행하지 않고 토큰도 사용하지 않습니다.

실패한 호출에도 비용이 청구되나요?

저희 측 문제일 때는 아닙니다. 잔액에서 토큰 단위로 결제합니다. 입력 및 출력 토큰은 모델 자체의 tokenizer로 계산되며, 해당 모델의 1M 토큰당 가격으로 청구됩니다. 오류로 끝난 호출은 비용이 들지 않습니다.

가동률 퍼센트를 공개하나요?

아니요. 보여드릴 수 없는 수치는 공개하지 않습니다. 대신 장애는 changelog에 날짜와 함께 기록됩니다.