Chuyển tới nội dung chính

Bắt đầu nhanh với curl

Kiểm tra toàn bộ đường truyền bằng yêu cầu OpenAI compatible tối thiểu.

Chuẩn bị​

  • Chuẩn bị YOUR_API_KEY trên trang khóa.
  • Chọn mô hình khả dụng trên trang mô hình và giá rồi thay cho YOUR_MODEL.
  • Xác nhận mạng truy cập được https://api.popgo.site.

Xem mô hình và giá hiện tại

Checklist trước khi kết nối​

  • Ban đầu chỉ thay YOUR_API_KEY và YOUR_MODEL. Không đổi đồng thời đường dẫn, giao thức và tùy chọn nâng cao của ứng dụng.
  • Nếu ứng dụng hỏi Base URL, nhập cấp root hoặc /v1 theo hướng dẫn tương ứng. Chỉ nhập Endpoint đầy đủ khi ứng dụng yêu cầu rõ.
  • Lấy một phản hồi thành công từ quickstart trước, rồi sao chép cùng Key, mô hình và địa chỉ vào ứng dụng.

Chọn địa chỉ và endpoint theo giao thức​

Ứng dụng OpenAI compatible thường dùng Base URL /v1. Claude Messages và Gemini native dùng địa chỉ root, sau đó ứng dụng hoặc Endpoint đầy đủ thêm đường dẫn giao thức.

Xem API Reference để biết đầy đủ endpoint công khai. Xem Tạo hình ảnh và video cho tác vụ video và tham số media.

Chuẩn bị môi trường cục bộ​

Nếu bạn chạy CLI, script tự động hoặc công cụ cần Node.js, hãy cài Node.js và npm trước. Kiểm tra phiên bản trong đúng terminal sẽ khởi động công cụ:

node --version
npm --version
  • Windows: dùng trình cài đặt chính thức hoặc trình quản lý gói hệ thống cho bản Node.js LTS.
  • macOS: dùng trình cài đặt chính thức hoặc Homebrew.
  • Linux/WSL2: dùng trình quản lý gói của bản phân phối hoặc cách cài đặt được Node.js khuyến nghị.
  • Nếu vẫn không tìm thấy lệnh sau khi cài, hãy đóng terminal cũ và mở terminal mới để nạp lại PATH.

Gửi yêu cầu​

Yêu cầu này dùng OpenAI compatible Base URL.

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "Hãy xác nhận kết nối"}
    ]
  }'

Dấu hiệu thành công​

Trạng thái HTTP thành công cùng nội dung trợ lý xác nhận Base URL, khóa và mô hình. Nếu lỗi, hãy xem mã trạng thái tương ứng trong phần khắc phục.

Bước tiếp theo​

Tiếp tục với hướng dẫn OpenAI, Claude hoặc Gemini mà ứng dụng hỗ trợ, hoặc chọn một tích hợp phần mềm.