빠른 답변
LLMwithCrypto API는 어떤 오류를 반환하며, 과금되나요?
API는 오류를 HTTP 상태와 OpenAI 형식 본문인 {"error": {"message", "type", "param", "code"}}로 응답합니다. LLMwithCrypto는 잘못된 요청에 400, 잘못된 키에 401, 크레딧으로 결제할 수 없을 때 402, 알 수 없는 모델에 404, rate limit에 429, 저희 측 문제에 500 또는 503을 사용합니다. 오류로 끝난 호출에는 비용이 들지 않습니다(2026년 10월 23일 문서 기준).
어떤 오류가 있나요?
어떤 오류도 크레딧을 사용하지 않습니다. code는 코드에서 테스트할 안정적인 값이고, message는 사람을 위한 값이며 변경될 수 있습니다.
| HTTP | code | 원인 | 재시도? |
|---|---|---|---|
| 400 | invalid_parameter | 필수 필드가 없거나, 값이 범위를 벗어났거나, 타입이 잘못되었습니다 | 아니요: 요청을 수정하세요 |
| 400 | context_length_exceeded | messages와 max_tokens가 모델의 컨텍스트 윈도우에 맞지 않습니다 | 아니요: 입력을 줄이거나 max_tokens를 낮추세요 |
| 400 | unsupported_parameter | 이 모델이 지원하지 않는 필드입니다. 예를 들어 JSON 모드가 없는 모델의 response_format | 아니요: 제거하거나 모델을 변경하세요 |
| 401 | invalid_api_key | 키가 없거나, 잘못 입력되었거나, 폐기되었습니다 | 아니요: 키를 확인하세요 |
| 402 | insufficient_balance | 남은 잔액으로는 이 호출을 지불할 수 없습니다 | 아니요: 크레딧 팩을 구매하세요 |
| 404 | model_not_found | model id는 저희 목록에 없습니다 | 아니요: GET /api/v1/models에서 id를 사용하세요 |
| 429 | rate_limit_exceeded | 분당 요청 또는 토큰이 계정이 허용하는 양보다 많습니다 | 예, 잠시 후에 |
| 500 | server_error | 저희 쪽에서 문제가 발생했습니다 | 예, 백오프와 함께 |
| 503 | model_overloaded | 모델이 잠시 용량 한계에 있습니다 | 예, 백오프와 함께 재시도하거나 다른 모델을 시도하세요 |
{
"error": {
"message": "The model `gpt-4o` does not exist or is not available to your key.",
"type": "invalid_request_error",
"param": "model",
"code": "model_not_found"
}
}
gpt-4o나 claude에 대해 404가 나오는 이유는 무엇인가요?
그 모델들은 여기서 판매하지 않기 때문입니다. 당사는 GPT, Claude, Gemini, Grok에 대한 접근 권한을 판매하지 않습니다: 해당 제작사는 자사 승인 없이 API 접근을 재판매하는 것을 금지하며, 당사는 그 승인을 받지 않았습니다. OpenAI API용으로 작성된 코드는 여러 곳에서 모델을 지정하는 경우가 많습니다. 프로젝트에서 예전 이름을 검색해 models 페이지의 id(예: deepseek-v4-pro 또는 gpt-oss-120b)로 바꾸세요.
코드는 언제 재시도해야 하나요?
429, 500, 503 및 타임아웃이나 연결 리셋 같은 네트워크 오류는 재시도하세요. 400, 401, 402, 404은 절대 재시도하지 마세요. 같은 요청은 같은 방식으로 실패합니다.
새 시도 전에 기다리세요. 응답에 Retry-After 헤더가 있으면 그 초만큼 기다리고, 없으면 매번 대기 시간을 두 배로 늘리고(1, 2, 4, 8초…) 약간의 무작위 시간을 더하세요. 그래야 여러 워커가 동시에 재시도하지 않습니다. 몇 번 시도 후 포기하고 오류를 로그로 남기세요. OpenAI SDK는 자체적으로 재시도하므로, 아래 예시는 로직을 전부 보여주기 위해 그 기능을 끕니다.
import os
import random
import time
from openai import APIConnectionError, APIStatusError, OpenAI
client = OpenAI(
base_url="https://llmwithcrypto.com/api/v1",
api_key=os.environ["LLMWITHCRYPTO_API_KEY"],
max_retries=0,
)
RETRY = {429, 500, 503}
def chat(messages, model="deepseek-v4-pro", attempts=5):
for attempt in range(attempts):
try:
return client.chat.completions.create(model=model, messages=messages, max_tokens=500)
except APIStatusError as err:
if err.status_code not in RETRY or attempt == attempts - 1:
raise
wait = err.response.headers.get("retry-after")
delay = float(wait) if wait else min(30, 2**attempt) + random.random()
except APIConnectionError:
if attempt == attempts - 1:
raise
delay = min(30, 2**attempt) + random.random()
time.sleep(delay)
402 insufficient_balance일 때 무엇을 해야 하나요?
충전하세요. 호출은 청구되지 않았고 계정의 다른 것은 바뀌지 않습니다. 크레딧이 다시 생기면 키는 계속 작동합니다. 암호화폐 충전이 확인되고 크레딧 팩을 구매하면 API 키가 대시보드에서 기다리고 있습니다.
프로덕션에서 예상치 못한 상황을 피하려면 GET https://llmwithcrypto.com/api/v1/credits을 가끔 읽고 원하는 하한 아래로 내려가면 알림을 받으세요. models and credits 페이지에서 호출을 보여줍니다. 크레딧에는 만료일이 없습니다. 이번 달에 쓰지 않은 크레딧은 내년에도 그대로 남아 있습니다, 그러므로 미리 큰 팩을 사도 추가 비용이 없습니다.
rate limit 아래에 머무르려면 어떻게 해야 하나요?
모든 계정에는 분당 요청 및 토큰 한도가 있으며 대시보드에 표시됩니다. 지원팀에 요청하면 한도를 올릴 수 있습니다.
- 동시성을 제한하세요. 한 번에 전체 배치를 보내지 말고 고정된 수의 요청을 병렬로 실행하세요.
- 출력을 제한하세요. 토큰 한도는 모델이 쓰는 것도 포함하므로 합리적인
max_tokens이 더 많은 요청을 한도 안에 유지합니다. - 배치를 분산하세요. 대규모 오프라인 작업은 요청을 몰아서 보내지 말고 1분에 걸쳐 분산하세요.
오류: 자주 묻는 질문
실패한 호출에도 비용이 청구되나요?
아니요. 잔액에서 토큰 단위로 결제합니다. 입력 및 출력 토큰은 모델 자체의 tokenizer로 계산되며, 해당 모델의 1M 토큰당 가격으로 청구됩니다. 오류로 끝난 호출은 비용이 들지 않습니다.
장애가 있는지 어디서 확인할 수 있나요?
status 페이지에서 확인할 수 있습니다. 여러 모델에서 500 또는 503 오류가 연달아 발생하면 보통 저희 쪽의 장애를 의미합니다. 지속되면 [email protected]으로 연락하세요.
실패한 요청을 볼 수 있나요?
저희 쪽에서는 볼 수 없습니다. 프롬프트와 모델의 답변은 저장하지 않습니다. 응답이 전송되면 그 텍스트는 사라집니다. 각 호출은 시간, 계정, 모델, 토큰 수를 담은 로그 한 줄을 남기며, 이는 30일 후 삭제됩니다. 앱에서 오류 code과 직접 만든 요청 id를 로그로 남기세요.