API Reference

Liệt kê model và giá

Trả mọi model mà KEY của bạn gọi được VÀ đang có kênh khoẻ (khác với toàn bộ bảng giá). Model có giá nhưng nhà cung cấp hết kênh sẽ không xuất hiện — đúng như hành vi của /v1/models: không quảng cáo một lựa chọn chắc chắn trả 502. Giá trong pricing_usd_per_1m là giá BÁN, đơn vị credit-$ (xem credit_vnd_per_usd).

Responses

Tạo message (Anthropic Messages API)

Chỉ cần đổi ANTHROPIC_BASE_URL sang endpoint này — request/response giữ nguyên hình dạng của Anthropic, kể cả stream: true (SSE được chuyển byte-exact). Đây là đường Claude Code dùng.

Body

Responses

curl -X POST https://api.apimodelhub.com/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

Đếm token (không tính tiền)

Chuyển tiếp nguyên văn tới nhà cung cấp. Không bị tính tiền và không trừ credit — dùng để chặn prompt quá lớn trước khi trả tiền cho model.

Body

Responses

curl -X POST https://api.apimodelhub.com/v1/messages/count_tokens \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Hello"}]}'

Chat completion (OpenAI-compatible)

Dùng được với mọi SDK OpenAI: chỉ đổi base_url. stream: true trả SSE; chúng tôi tự thêm stream_options.include_usage để ghi nhận token chính xác (và bỏ nó khỏi phần trả về của bạn).

Body

Responses

curl -X POST https://api.apimodelhub.com/v1/chat/completions \
  -H "authorization: Bearer $API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Hello"}],"max_tokens":256}'

Responses API (OpenAI)

Endpoint mới của OpenAI. Hình dạng request/response giữ nguyên.

Body

Responses

curl -X POST https://api.apimodelhub.com/v1/responses \
  -H "authorization: Bearer $API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","input":"Hello"}'

Gemini generateContent

Hình dạng của google-genai SDK. Đổi base_url sang endpoint này; header auth là x-goog-api-key (SDK tự gửi). Chỉ model gemini-* đi được đường này: model Claude/OpenAI/grok gọi vào đây sẽ nhận 404 từ chính Google. Với :streamGenerateContent thêm ?alt=sse (gateway tự thêm nếu thiếu).

Path parameters

Body

Responses

curl -X POST https://api.apimodelhub.com/v1beta/models/MODEL:generateContent \
  -H "x-goog-api-key: $API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'

Gemini countTokens (không tính tiền)

Đếm token của một request trước khi gửi, để chặn prompt quá lớn. Chuyển nguyên văn tới Google và KHÔNG bị tính tiền, không trừ hạn mức — giống POST /v1/messages/count_tokens của Anthropic.

Path parameters

Body

Responses

curl -X POST https://api.apimodelhub.com/v1beta/models/MODEL:countTokens \
  -H "x-goog-api-key: $API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'

Gemini streamGenerateContent

Như generateContent nhưng trả SSE. Chúng tôi tự thêm alt=sse nếu request thiếu — thiếu nó thì Gemini trả JSON array và không stream được.

Path parameters

Responses