Các Định Danh Công Khai Cần Ghi Nhận
| Định danh | Nơi xuất hiện | Sử dụng cho |
|---|---|---|
request_id | Nội dung lỗi, bản ghi bảng điều khiển, hồ sơ sử dụng | Hỗ trợ và đối chiếu ở cấp độ yêu cầu |
id / task_id | Phản hồi tạo không đồng bộ và trạng thái | Lấy thông tin hình ảnh, video, âm nhạc và công việc 3D |
poll_url | Phản hồi tạo không đồng bộ | URL trạng thái ưa thích |
billing_transaction_id | Phản hồi không phát trực tiếp khi đã thanh toán, phản hồi trạng thái nhiệm vụ không đồng bộ, hồ sơ sử dụng, X-Billing-Transaction-ID | Đối chiếu chi phí |
X-Task-ID | Tiêu đề phản hồi nhiệm vụ không đồng bộ | Tương quan nhiệm vụ ở cấp độ tiêu đề |
| ID công việc/người dùng của bạn | Ứng dụng của bạn | Kết nối hoạt động của TokenLab trở lại quy trình làm việc của người dùng |
Những Gì Cần Ghi Nhận
Ghi lại đủ thông tin để chẩn đoán yêu cầu mà không tiết lộ bí mật:- Điểm cuối, phương thức HTTP, mô hình, mã trạng thái, dấu thời gian và độ trễ.
- Các định danh công khai:
request_id,task_id,poll_url, vàbilling_transaction_idkhi có. - Hình dạng yêu cầu đã được làm sạch: các trường nào có mặt, không phải toàn bộ lời nhắc hoặc nội dung phương tiện riêng tư.
- Phản hồi trạng thái không đồng bộ cuối cùng, bao gồm các trường lỗi công khai.
- Số lần thử lại của khách hàng và liệu lần thử lại có tạo ra một nhiệm vụ mới hay tiếp tục một nhiệm vụ hiện có.
Authorization, API keys, management tokens, signed URLs, private media URLs, toàn bộ lời nhắc, và dữ liệu cá nhân của người dùng trừ khi bạn có sự cho phép rõ ràng để giữ lại chúng.
Ma Trận Khắc Phục Sự Cố
| Triệu chứng | Kiểm tra đầu tiên | Trang hữu ích |
|---|---|---|
401 hoặc 403 | API key, management token, quyền truy cập tổ chức, phạm vi khóa | Xác thực |
402 | Số dư, giới hạn chi tiêu API key, giá mô hình có sẵn | Thanh toán & Giá cả |
429 | Cấp tài khoản, giới hạn tỷ lệ điểm cuối, hành vi thử lại | Giới hạn Tỷ lệ |
400 invalid_request_error | Trường không được hỗ trợ, điểm cuối sai, thiếu trường bắt buộc, hoặc không khớp hợp đồng mô hình | Xử lý Lỗi |
| Nhiệm vụ không đồng bộ không thể tìm thấy | API key sai, ID nhiệm vụ cũ, nhiệm vụ hết hạn, hoặc ID nhiệm vụ không công khai | Công việc Không đồng bộ & Lấy thông tin |
| Chi phí không khớp với UI | Thời gian thanh toán hoặc so sánh định danh sai | Thanh toán & Giá cả |
Đối Chiếu Sử Dụng
Sử dụng Management API để đối chiếu phía máy chủ:GET /v1/management/api-keys/{keyId}/usage có thể lọc theo scene, accessChannel, logicalModel, modelVendor, startDate, và endDate. Sử dụng các bản ghi này thay vì lấy thông tin từ các trang bảng điều khiển hoặc dựa vào ID nhiệm vụ của nhà cung cấp upstream.
Các phản hồi phát trực tiếp có thể được thanh toán sau khi luồng được gửi, vì vậy một tiêu đề thanh toán có thể không có ngay cả khi việc sử dụng được ghi lại sau đó. Các nhiệm vụ phương tiện không đồng bộ có thể được thanh toán sau khi lấy thông tin cuối cùng.
Mẫu Gói Hỗ Trợ
Khi liên hệ với hỗ trợ, bao gồm:request_id.task_idvàpoll_urlcho công việc không đồng bộ.billing_transaction_idkhi có.- Điểm cuối, phương thức, mô hình, dấu thời gian, và mã trạng thái.
- Hình dạng yêu cầu đã được làm sạch và nội dung lỗi công khai.
- Kết quả mong đợi của bạn và những gì người dùng thực sự thấy.
Kiểm Tra Vận Hành
- Cảnh báo về các phản hồi
401,402,429, và5xxlặp lại riêng biệt; chúng thường có các chủ sở hữu khác nhau. - Theo dõi các công việc không đồng bộ vẫn không kết thúc lâu hơn SLA sản phẩm của bạn.
- Theo dõi các nỗ lực tạo trùng lặp cho cùng một ID công việc của người dùng.
- Lấy mẫu các công việc đã hoàn thành và xác minh tài sản có thể nhìn thấy của người dùng, hồ sơ sử dụng, và bản ghi nhiệm vụ đã lưu trữ đồng ý.
Tài Liệu API
| Chủ đề | Tài liệu tham khảo |
|---|---|
| Xử lý Lỗi | Xử lý Lỗi |
| Giới hạn Tỷ lệ | Giới hạn Tỷ lệ |
| Thanh toán & Giá cả | Thanh toán & Giá cả |
| Lấy Thông tin Sử dụng API Key | Lấy Thông tin Sử dụng API Key |
| Lấy Trạng thái Nhiệm vụ | Lấy Trạng thái Nhiệm vụ |