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

Câu hỏi thường gặp

Trước hết hãy kiểm tra yêu cầu API và cấu hình ứng dụng, sau đó mới xử lý lỗi cụ thể.

Yêu cầu API​

Làm sao xác nhận API Key đã được sao chép đầy đủ​

Key thường chỉ hiển thị đầy đủ một lần. Hãy sao chép vào nơi an toàn trên máy và kiểm tra khoảng trắng, xuống dòng hoặc dấu ngoặc kép kiểu chữ. Nếu không còn thấy giá trị đầy đủ, hãy tắt Key cũ và tạo Key mới thay vì đoán.

Nên kiểm tra phần mềm hay curl trước​

Hãy kiểm tra curl trước. Địa chỉ, Key, mô hình và nội dung yêu cầu đều rõ ràng, giúp loại trừ bộ nhớ đệm và biến môi trường của ứng dụng.

Vì sao curl chạy được nhưng phần mềm thất bại​

Kiểm tra loại Provider, cấp độ Base URL, các trường API Key và Model, sau đó tạo cuộc trò chuyện mới hoặc khởi động lại ứng dụng.

Base URL khác Endpoint đầy đủ như thế nào​

Base URL là gốc của giao thức và ứng dụng sẽ nối thêm đường dẫn. Endpoint đầy đủ đã chứa đường dẫn thao tác cụ thể.

Vì sao danh sách mô hình trống​

Nhiều ứng dụng không tự lấy danh sách mô hình bên thứ ba. Nếu Key và Base URL đúng, hãy sao chép YOUR_MODEL từ trang mô hình và giá rồi nhập thủ công.

Làm sao biết tài khoản hoặc quota không đủ​

Nếu yêu cầu trả về 403 hoặc 429 sau khi đã xác nhận Key, mô hình và đường dẫn, hãy kiểm tra trạng thái tài khoản, quota và khả năng sử dụng mô hình hiện tại trên cổng. Đừng dựa vào ảnh chụp cũ trong tài liệu công khai.

Khoanh vùng bằng yêu cầu tối thiểu​

Giữ nguyên URL, Key, mô hình và nội dung rồi gửi một tin nhắn ngắn. Nếu curl thành công, hãy kiểm tra cấu hình ứng dụng hoặc phiên cũ; nếu vẫn lỗi, dùng mã HTTP trong phần Khắc phục lỗi.

Ứng dụng và môi trường cục bộ​

Không tìm thấy lệnh​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Không tìm thấy lệnh”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Terminal không tìm thấy claude, codex hoặc gemini, thường do thư mục cài đặt chưa nằm trong PATH hoặc terminal cũ chưa làm mới môi trường.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Mở terminal mới và chạy lệnh xem phiên bản. Nếu vẫn lỗi, cài lại từ nguồn chính thức và tránh mirror không rõ nguồn.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Biến môi trường chưa có hiệu lực​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Biến môi trường chưa có hiệu lực”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Biến được đặt trong một terminal, nhưng ứng dụng lại chạy từ cửa sổ cũ, shortcut desktop hoặc tiến trình nền khác.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: In biến trong đúng terminal dùng để khởi động ứng dụng, sau đó đóng phiên cũ và mở lại sau khi đặt biến.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Đã lưu nhưng vẫn gọi dịch vụ mặc định​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Đã lưu nhưng vẫn gọi dịch vụ mặc định”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Ứng dụng có thể cache Provider cũ, hoặc hội thoại hiện tại chưa chuyển sang cấu hình mới.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Tạo hội thoại mới hoặc khởi động lại ứng dụng, rồi xác nhận Provider, Base URL, Key và mô hình đều đến từ cấu hình PopGo.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Mô hình không khả dụng​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Mô hình không khả dụng”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Chính tả model ID, phạm vi truy cập hoặc trạng thái khả dụng trực tiếp đã thay đổi.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Sao chép lại model ID từ trang mô hình và giá, rồi kiểm tra bằng yêu cầu tối thiểu thay vì gõ theo ảnh chụp cũ.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Lỗi quyền khi cài npm toàn cục​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Lỗi quyền khi cài npm toàn cục”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Windows có thể thiếu quyền cài đặt; macOS/Linux có thể dùng thư mục toàn cục không cho ghi do cách cài Node.js.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Trên Windows, khi cần hãy mở lại PowerShell với quyền phù hợp. Trên macOS/Linux, ưu tiên cách cài chính thức hoặc trình quản lý gói để thư mục toàn cục thuộc về người dùng hiện tại; không phụ thuộc lâu dài vào sudo npm install -g.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Claude Code yêu cầu đăng nhập tài khoản chính thức​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Claude Code yêu cầu đăng nhập tài khoản chính thức”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Claude Code không đọc được biến môi trường nên quay về quy trình đăng nhập chính thức.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Kiểm tra ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trong cùng terminal, đóng cửa sổ cũ, khởi động lại công cụ và chạy claude doctor.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Codex báo lỗi xác thực​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Codex báo lỗi xác thực”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Thiết lập cục bộ không đọc được POPGO_API_KEY, hoặc Provider, model_provider và env_key trong config.toml không khớp.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Xác nhận tên biến chính xác là POPGO_API_KEY, sau đó kiểm tra model_provider = popgo khớp với model_providers.popgo.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Base URL trả về 404​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Base URL trả về 404”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Ứng dụng có thể nối thêm đường dẫn vào giá trị đã nhập, tạo ra /v1/v1 hoặc Endpoint đầy đủ bị lặp.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Xem bảng cấp Base URL trong Quickstart: trường Base URL nhập gốc giao thức, còn đường dẫn đầy đủ chỉ nhập trong trường Endpoint đầy đủ.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Lỗi chứng chỉ hoặc SSL​

  • Hiện tượng: Ứng dụng hoặc terminal thường hiển thị “Lỗi chứng chỉ hoặc SSL”, hoặc đã lưu cấu hình nhưng yêu cầu vẫn lỗi.
  • Nguyên nhân: Nguyên nhân thường là proxy cục bộ, mạng công ty chặn, đồng hồ hệ thống sai hoặc chuỗi chứng chỉ bị lỗi.
  • Tự kiểm tra:
    1. Kiểm tra lệnh, biến môi trường, Provider, Base URL, Key và mô hình trong đúng phiên khởi động ứng dụng.
    2. Đóng phiên và tiến trình cũ rồi khởi động lại.
    3. Đối chiếu URL cuối cùng với bảng Quickstart.
  • Cách xử lý: Không tắt xác minh TLS. Kiểm tra giờ hệ thống, thử tắt proxy cục bộ hoặc đổi mạng, rồi kiểm tra phần mềm bảo mật có chặn HTTPS hay không.
  • Xác minh: Khởi động lại ứng dụng và gửi tin nhắn ngắn. Chỉ coi là khôi phục khi nhận nội dung bình thường với URL, mô hình và xác thực đúng.

Âm thanh tham chiếu khác đầu ra thế nào?​

generate_audio chỉ điều khiển track đầu ra,không xác nhận đầu vào. Khả năng quyết định tên video/âm thanh,chỉ video,chỉ âm thanh. Chế độ video cần video,chế độ audio cần âm thanh.

Vì sao C có âm thanh nhưng không có video?​

C loại trừ video rõ ràng;không để trống để vượt số0. Cho phép tối đa3 tệp âm thanh tham chiếu. Kling chưa công bố trường tham chiếu âm thanh nên vẫn đóng;Grok cũng không hỗ trợ.

Dán media trực tuyến luôn giữ URL công khai?​

URL HTTP(S) rõ sẽ được giữ,nhưng chỉ sao chép byte vẫn là cục bộ. Kết quả tạo chỉ công khai khi giữ sourceUrl. Nhãn xem nguồn không bảo đảm dịch vụ truy cập. Mô hình không Base64 cần URL đọc được.

Vì sao có ID nhưng tham chiếu không tác dụng?​

ID chỉ chứng minh nhận tác vụ. Kiểm tra chế độ,trường,tải,thành phẩm. Khung đầu khác ảnh tham chiếu;một trường bị bỏ qua vẫn có thể tính phí. XemQuy trình video.

Thứ tự kiểm tra đề xuất​

  1. Trước tiên lưu lại lỗi đầy đủ: trạng thái HTTP, đường dẫn, ứng dụng và thời điểm.
  2. Dùng yêu cầu curl tối thiểu trong Quickstart để tái hiện và tách nguyên nhân do Key, mô hình, URL hay ứng dụng.
  3. Mỗi lần chỉ đổi một biến. Xác minh yêu cầu văn bản ngắn trước khi bật lại streaming, tools hoặc tham số media.