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

Khắc phục lỗi

Dựa vào hiện tượng và mã trạng thái HTTP để tìm nguyên nhân, kiểm tra cách sửa tối thiểu rồi khôi phục yêu cầu từng bước.

401 Chưa xác thực​

  • Hiện tượng: Yêu cầu thường trả về 401 Chưa xác thực; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Key bị thiếu, không hoạt động, sao chép thiếu hoặc gửi sai header xác thực.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Sao chép lại Key, bỏ khoảng trắng và kiểm tra Bearer, x-api-key hoặc x-goog-api-key theo giao thức.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

403 Bị từ chối​

  • Hiện tượng: Yêu cầu thường trả về 403 Bị từ chối; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Key hiện tại, trạng thái tài khoản hoặc quyền truy cập mô hình không cho phép yêu cầu.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Xác nhận Key còn hoạt động và chọn mô hình hiện có trên trang mô hình và giá.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

404 Không tìm thấy​

  • Hiện tượng: Yêu cầu thường trả về 404 Không tìm thấy; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Base URL, đường dẫn giao thức hoặc phương thức HTTP không khớp; ứng dụng cũng có thể nối /v1 hai lần.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Đối chiếu phương thức và đường dẫn đầy đủ với hướng dẫn, chỉ nhập đúng cấp Base URL được nêu.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

429 Quá nhiều yêu cầu​

  • Hiện tượng: Yêu cầu thường trả về 429 Quá nhiều yêu cầu; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Yêu cầu quá dày hoặc số dư hiện có không đủ.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Giảm đồng thời, thử lại với khoảng chờ tăng dần và kiểm tra trạng thái tài khoản trên cổng.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

5xx Lỗi dịch vụ​

  • Hiện tượng: Yêu cầu thường trả về 5xx Lỗi dịch vụ; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Dịch vụ phía trên hoặc gateway tạm thời không hoàn thành yêu cầu.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Lưu thời điểm và trạng thái rồi thử lại sau. Nếu tiếp diễn, dùng curl tối thiểu để loại trừ cấu hình ứng dụng.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

Mất kết nối mạng​

  • Hiện tượng: Yêu cầu thường trả về Mất kết nối mạng; ứng dụng đôi khi chỉ hiển thị “yêu cầu thất bại”.
  • Nguyên nhân: Mạng cục bộ, proxy hoặc kết nối dài bị đóng trước khi phản hồi hoàn tất.
  • Tự kiểm tra:
    1. Lưu đầy đủ trạng thái HTTP, đường dẫn và thời điểm.
    2. Sao chép lại Key, kiểm tra khoảng trắng, hạn dùng và trạng thái hoạt động.
    3. Đối chiếu URL, mô hình và header xác thực với hướng dẫn, sau đó kiểm tra bằng curl tối thiểu.
  • Cách xử lý: Kiểm tra tên miền, kết nối lại stream với backoff và không tự động lặp thao tác không idempotent.
  • Xác minh: Sau khi sửa, gửi một yêu cầu văn bản ngắn trước. Chỉ khôi phục tham số nâng cao khi JSON bình thường đã trả về.

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.

Nếu vẫn chưa khôi phục​

Lưu thời điểm, giao thức, phương thức HTTP, đường dẫn, trạng thái và đoạn phản hồi đã che dữ liệu nhạy cảm. Không gửi toàn bộ Key.

Chẩn đoán lỗi video​

Xác định trước gửi,phân tích PopGo,nhận,thăm dò hay tải. Giữ lỗi cụ thể;500 hoặc không log không đủ kết luận nguyên nhân.

Giai đoạnHành động
first-frame requires exactly one / first-last-frame requires bothChọn chế độ,một ảnh hoặc hai ô khác nhau;kiểm tra liên kết và số thật
reference-audio requires at least one / audio not supportedKiểm tra khả năng và quyền gắn âm thanh của chế độ,cung cấp âm thanh;generate_audio không cho phép tham chiếu
unsupported protocol: data / invalid sourceMô hình URL-only dùng URL công khai được phép;nhãn cục bộ không xuất bản tệp
0% kéo dài / completed tải lỗiTruy vấn id cũ,chờ chuẩn bị nội dung,không tạo lại
Thành công nhưng bỏ quaKiểm tra trường,khả năng đọc,thành phẩm;HTTP200 chưa đủ

400 thường cần sửa yêu cầu;500 có thể từ phân tích hoặc lớp trung gian;503 thường thiếu năng lực tạm. Đọc chi tiết đã ẩn dữ liệu trước. XemChẩn đoán tác vụ.