AGYStore

🚀 Bắt đầu nhanh

1. Lấy API key sau khi mua gói.
2. Cấu hình ANTHROPIC_AUTH_TOKEN và ANTHROPIC_BASE_URL.
3. Mở lại Claude Code rồi kiểm tra model bằng GET /v1/models.

🧩 Claude Code CLI / VSCode

Dùng cùng cấu hình cho CLI và VSCode Extension.

Vị trí cấu hình

• Linux / macOS: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.agydev.store"
  }
}

🤖 Model

Danh sách thực tế của từng key luôn lấy từ GET /v1/models. Các ID hiện được cấu hình gồm:

Nếu một model không xuất hiện trong GET /v1/models, key hiện tại không được cấp model đó.

🧠 Codex / Astra-6

Codex vẫn được giữ nguyên với model astra-6. Chỉ phương thức kết nối dùng chung Anthropic Messages.

🌐 Endpoint hỗ trợ

🛠️ Claude Code Compatibility

AGYStore nhận request theo giao thức Anthropic Messages. Hãy dùng model xuất hiện trong GET /v1/models và giữ nguyên cấu trúc request của ứng dụng Anthropic.

📊 Quota, RPM và giá

Xem gói, thời hạn, giới hạn tốc độ và giá hiện hành trong mục Ví & Dịch vụ của bot. Điều kiện có thể khác nhau theo dịch vụ và tài khoản.

Lịch sử sử dụng hiển thị trong bot theo tài khoản của bạn. Khi cần hỗ trợ, chỉ gửi mã request_id; không gửi API key hoặc prompt riêng tư.

💳 Mua quota và nạp Ví

Nạp ví bằng chuyển khoản theo hướng dẫn trong liên kết thanh toán. Số dư chỉ được cập nhật sau khi hệ thống xác nhận giao dịch.

Mở Ví & Dịch vụ trong bot để xem số dư, quota từng dịch vụ, giá, đơn đã mua và lượt sử dụng. Mua quota có thể thanh toán từ ví hoặc chuyển khoản.

🤖 Sử dụng bot Discord

1. Mở bot AGYStore và dùng lệnh /panel để mở bảng riêng.
2. Chọn Tài khoản để xem định danh, số dư, quota, sử dụng, thông báo và mã giới thiệu.
3. Chọn API Key để tạo hoặc thu hồi key; key mới chỉ hiển thị một lần.
4. Dùng Ví & Dịch vụ, Tích hợp và Hỗ trợ để quản lý phần tương ứng.

🔑 Tạo và bảo vệ API key

1. Trong bảng Discord, chọn API Key → Tạo key, nhập tên nhận biết và xác nhận.
2. Sao chép key ngay khi bot hiển thị. Sau đó bot chỉ hiện phần đã che.
3. Nếu key bị lộ hoặc không còn sử dụng, chọn key đó để thu hồi rồi xác nhận.

Dùng key cá nhân với https://api.agydev.store. Key quản lý Reseller và key suy luận Reseller có phạm vi riêng, xem mục Reseller.

🏢 Reseller: API quản lý và gọi AI

Gửi hồ sơ tại Discord → Tích hợp → Đăng ký Reseller. Sau khi hồ sơ được duyệt và kích hoạt, quản lý key, ví, mức giá, giao dịch và lượt dùng qua API Reseller.

Hai loại khóa khác nhau

• Khóa quản lý bắt đầu bằng rsc_live_, cấp trong Discord và chỉ gọi được API quản lý.
• Khóa suy luận bắt đầu bằng rsk_live_, tạo qua API quản lý và dùng gọi model; chi phí trừ vào ví Reseller.

Cả hai khóa chỉ hiển thị một lần. Không dùng khóa quản lý để gọi model, hoặc khóa suy luận để quản lý ví/key.

Tạo khóa suy luận

curl -X POST "https://reseller.agydev.store/v1/supplier/keys" \
  -H "Authorization: Bearer rsc_live_YOUR_MANAGEMENT_KEY" \
  -H "Idempotency-Key: create-customer-key-001" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-prod"}'

Gọi model

curl -X POST "https://reseller.agydev.store/v1/messages" \
  -H "x-api-key: rsk_live_YOUR_INFERENCE_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_FROM_V1_MODELS","max_tokens":256,"messages":[{"role":"user","content":"Xin chào"}]}'

Danh sách endpoint quản lý, phân trang và định dạng lỗi có trong đặc tả API và sẽ được bổ sung trong hướng dẫn Reseller.

🔗 Webhook

Trong Discord → Tích hợp, cấu hình một địa chỉ HTTPS, bật/tạm dừng gửi, xoay khóa xác thực hoặc xóa webhook.

Khóa xác thực webhook chỉ hiển thị một lần khi tạo hoặc xoay. Hãy lưu khóa ở máy chủ nhận webhook và kiểm tra chữ ký theo hướng dẫn tích hợp; không gửi khóa này cho khách hàng hoặc đăng lên Discord.

💬 Hỗ trợ và giới thiệu

Mở Hỗ trợ trong bot để xem yêu cầu, tạo yêu cầu mới hoặc phản hồi một yêu cầu hiện có. Khi báo lỗi API, gửi mã request_id, thời điểm và mô tả ngắn; không gửi key, mật khẩu hay nội dung riêng tư.

Mở Tài khoản → Chương trình giới thiệu để xem trạng thái và mã của bạn. Người mới có thể nhập mã tại cùng mục này khi đăng ký.

🧯 Xử lý lỗi

Claude Code báo 400 BadRequest

1. Chạy claude --version.
2. Cập nhật Claude Code lên bản mới rồi mở lại CLI/VSCode.
3. Kiểm tra ANTHROPIC_BASE_URL=https://api.agydev.store, không có /v1 ở cuối.
4. Kiểm tra API key và model bằng GET /v1/models.
5. Nếu vẫn lỗi, gửi request_id cho hỗ trợ. Không gửi API key hoặc prompt riêng tư.

Các lỗi khác

• 401: API key thiếu, sai hoặc có khoảng trắng thừa.
• 402/410: quota hoặc thời hạn tài khoản không còn đủ.
• 429: vượt RPM; giảm tác vụ chạy đồng thời và thử lại.
• 5xx: dịch vụ nguồn hoặc gateway tạm thời không sẵn sàng.
• Không thấy API key: mở bot Discord → API Key, hoặc liên hệ hỗ trợ kèm request ID; không gửi key hoặc prompt riêng tư.

🔐 Bảo mật

• Không đăng API key lên Discord, GitHub, forum hoặc ảnh chụp màn hình.
• Không hard-code key vào source code hoặc repository.
• Không gửi prompt, tool input/output hoặc dữ liệu riêng tư khi báo lỗi nếu không cần thiết.
• Nếu key đã lộ, hãy rotate/thu hồi key cũ.