Trả lời nhanh
API LLMwithCrypto có thể trả về những lỗi nào, và chúng có bị tính phí không?
API trả lỗi kèm một HTTP status và body kiểu OpenAI: {"error": {"message", "type", "param", "code"}}. LLMwithCrypto dùng 400 cho yêu cầu sai, 401 cho khóa sai, 402 khi credit không đủ trả, 404 cho model không xác định, 429 cho rate limit và 500 hoặc 503 ở phía chúng tôi. Một lệnh gọi kết thúc bằng lỗi không tốn phí, theo tài liệu ngày 23 tháng 10 năm 2026.
Có những lỗi nào?
Không lỗi nào dùng credit. code là giá trị ổn định để kiểm tra trong code của bạn; message dành cho con người và có thể thay đổi.
| HTTP | code | Nguyên nhân | Retry? |
|---|---|---|---|
| 400 | invalid_parameter | Thiếu trường bắt buộc, hoặc giá trị nằm ngoài phạm vi hay sai kiểu | Không: sửa yêu cầu |
| 400 | context_length_exceeded | Các messages cộng với max_tokens không vừa với context window của model | Không: rút ngắn đầu vào hoặc giảm max_tokens |
| 400 | unsupported_parameter | Một trường mà model này không hỗ trợ, chẳng hạn response_format trên model không có JSON mode | Không: bỏ nó đi hoặc đổi model |
| 401 | invalid_api_key | Khóa bị thiếu, gõ sai hoặc đã bị thu hồi | Không: kiểm tra khóa |
| 402 | insufficient_balance | Số dư credit còn lại không đủ trả cho lần gọi này | Không: mua một pack credit |
| 404 | model_not_found | Id model không có trong danh sách của chúng tôi | Không: dùng một id từ GET /api/v1/models |
| 429 | rate_limit_exceeded | Số request hoặc token mỗi phút vượt quá mức tài khoản cho phép | Có, sau một khoảng tạm dừng |
| 500 | server_error | Có lỗi ở phía chúng tôi | Có, với backoff |
| 503 | model_overloaded | Model đang hết công suất trong chốc lát | Có, với backoff, hoặc thử một model khác |
{
"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"
}
}
Tại sao tôi nhận 404 với gpt-4o hoặc claude?
Vì các model đó không được bán ở đây. Chúng tôi không bán quyền truy cập GPT, Claude, Gemini hay Grok: nhà sản xuất của chúng cấm bán lại quyền truy cập API khi chưa có sự chấp thuận của họ, và chúng tôi không có sự chấp thuận đó. Code viết cho OpenAI API thường đặt tên model ở nhiều chỗ; hãy tìm trong dự án của bạn tên cũ và thay bằng một id từ trang models, chẳng hạn deepseek-v4-pro hoặc gpt-oss-120b.
Khi nào code của tôi nên retry?
Retry 429, 500 và 503, cùng các lỗi mạng như timeout hoặc kết nối bị reset. Không bao giờ retry 400, 401, 402 hoặc 404: cùng request đó sẽ thất bại y như vậy.
Hãy chờ trước mỗi lần thử mới. Khi response có header Retry-After, chờ đúng số giây đó; nếu không, nhân đôi thời gian tạm dừng sau mỗi lần (1, 2, 4, 8 giây…) và cộng thêm một chút thời gian ngẫu nhiên, để nhiều worker không retry cùng nhịp. Bỏ cuộc sau vài lần thử và ghi log lỗi. Các OpenAI SDK vốn đã tự retry; ví dụ dưới đây tắt tính năng đó để trình bày toàn bộ logic.
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)
Tôi nên làm gì với 402 insufficient_balance?
Nạp thêm. Lần gọi đó không bị tính phí, và không có gì khác trên tài khoản thay đổi: các khóa của bạn hoạt động lại ngay khi có credit. Khi khoản nạp crypto của bạn được xác nhận và một pack credit được mua, khóa API của bạn đã chờ sẵn trong dashboard.
Để tránh bất ngờ trong production, hãy đọc GET https://llmwithcrypto.com/api/v1/credits định kỳ và tự cảnh báo khi dưới một ngưỡng bạn chọn; trang models và credits hiển thị lần gọi. Credit không có ngày hết hạn: những gì bạn không dùng trong tháng này vẫn còn đó vào năm sau, nên một pack lớn hơn mua sớm không tốn thêm gì.
Làm sao để tôi ở dưới rate limit?
Mỗi tài khoản có giới hạn request và token mỗi phút, hiển thị trong dashboard; liên hệ support để được nâng lên.
- Giới hạn concurrency. Chạy một số cố định request song song thay vì bắn cả loạt cùng lúc.
- Giới hạn output. Giới hạn token cũng tính cả những gì model viết ra, nên một
max_tokenshợp lý giữ được nhiều request hơn trong mức limit. - Dàn trải các batch. Với các job offline lớn, hãy rải đều request trong phút thay vì gửi theo từng đợt dồn dập.
Lỗi: câu hỏi thường gặp
Tôi có bị tính phí cho lần gọi thất bại không?
Không. Bạn trả tiền theo token từ số dư của mình: token đầu vào và đầu ra được đếm bằng tokenizer của chính model và tính theo giá của model đó trên 1M token. Một lần gọi kết thúc bằng lỗi thì không mất phí.
Tôi xem được ở đâu nếu có sự cố?
Trên trang status. Một loạt lỗi 500 hoặc 503 trên nhiều model thường nghĩa là có sự cố phía chúng tôi; hãy viết tới [email protected] nếu nó kéo dài.
Tôi có xem được request bị lỗi không?
Không, ở phía chúng tôi. Chúng tôi không lưu prompt của bạn hay câu trả lời của model: khi một phản hồi được gửi đi, văn bản của nó biến mất. Mỗi lần gọi để lại một dòng log với thời gian, tài khoản, model và số token, bị xóa sau 30 ngày. Hãy ghi log lỗi code và id request của chính bạn trong ứng dụng.