Pengenal Publik yang Harus Ditangkap
| Pengenal | Di mana muncul | Gunakan untuk |
|---|---|---|
request_id | Badan kesalahan, log dasbor, catatan penggunaan | Dukungan dan rekonsiliasi tingkat permintaan |
id / task_id | Respons pembuatan dan status asinkron | Memantau gambar, video, musik, dan pekerjaan 3D |
poll_url | Respons pembuatan asinkron | URL status yang diinginkan |
billing_transaction_id | Respons non-streaming saat diselesaikan, respons status tugas asinkron, catatan penggunaan, X-Billing-Transaction-ID | Rekonsiliasi biaya |
X-Task-ID | Header respons tugas asinkron | Korelasi tugas tingkat header |
| ID pekerjaan/pengguna Anda sendiri | Aplikasi Anda | Menghubungkan aktivitas TokenLab kembali ke alur kerja pengguna |
Apa yang Harus Dicatat
Catat cukup untuk mendiagnosis permintaan tanpa membocorkan rahasia:- Endpoint, metode HTTP, model, kode status, timestamp, dan latensi.
- Pengenal publik:
request_id,task_id,poll_url, danbilling_transaction_idjika ada. - Bentuk permintaan yang disanitasi: bidang mana yang ada, bukan prompt lengkap atau konten media pribadi.
- Respons status asinkron terminal, termasuk bidang kesalahan publik.
- Jumlah percobaan ulang klien dan apakah percobaan ulang tersebut membuat tugas baru atau melanjutkan yang sudah ada.
Authorization, kunci API, token manajemen, URL yang ditandatangani, URL media pribadi, prompt lengkap, dan data pribadi pengguna kecuali Anda memiliki izin eksplisit untuk menyimpannya.
Matriks Pemecahan Masalah
| Gejala | Periksa pertama | Halaman berguna |
|---|---|---|
401 atau 403 | Kunci API, token manajemen, akses organisasi, cakupan kunci | Autentikasi |
402 | Saldo, batas pengeluaran kunci API, ketersediaan harga model | Penagihan & Harga |
429 | Tingkat akun, batas laju endpoint, perilaku percobaan ulang | Batas Laju |
400 invalid_request_error | Bidang tidak didukung, endpoint salah, bidang yang diperlukan hilang, atau ketidakcocokan kontrak model | Penanganan Kesalahan |
| Tugas asinkron tidak dapat ditemukan | Kunci API salah, ID tugas kadaluarsa, tugas kadaluarsa, atau ID tugas non-publik | Pekerjaan Asinkron & Pemantauan |
| Biaya tidak cocok dengan UI | Waktu penyelesaian atau membandingkan pengenal yang salah | Penagihan & Harga |
Rekonsiliasi Penggunaan
Gunakan API Manajemen untuk rekonsiliasi sisi server:GET /v1/management/api-keys/{keyId}/usage dapat memfilter berdasarkan scene, accessChannel, logicalModel, modelVendor, startDate, dan endDate. Gunakan catatan ini alih-alih menggores halaman dasbor atau bergantung pada ID tugas penyedia hulu.
Respons streaming mungkin diselesaikan setelah aliran dikirim, jadi header penagihan bisa tidak ada bahkan ketika penggunaan dicatat kemudian. Tugas media asinkron mungkin diselesaikan setelah pemantauan terminal.
Template Paket Dukungan
Saat menghubungi dukungan, sertakan:request_id.task_iddanpoll_urluntuk pekerjaan asinkron.billing_transaction_idjika ada.- Endpoint, metode, model, timestamp, dan kode status.
- Bentuk permintaan yang disanitasi dan badan kesalahan publik.
- Hasil yang Anda harapkan dan apa yang sebenarnya dilihat pengguna.
Pemeriksaan Operasional
- Beri peringatan pada respons
401,402,429, dan5xxyang berulang secara terpisah; biasanya mereka memiliki pemilik yang berbeda. - Lacak pekerjaan asinkron yang tetap non-terminal lebih lama dari SLA produk Anda.
- Lacak upaya pembuatan duplikat untuk ID pekerjaan pengguna yang sama.
- Sampel pekerjaan yang telah selesai dan verifikasi aset yang terlihat oleh pengguna, catatan penggunaan, dan catatan tugas yang disimpan setuju.
Referensi API
| Topik | Referensi |
|---|---|
| Penanganan Kesalahan | Penanganan Kesalahan |
| Batas Laju | Batas Laju |
| Penagihan & Harga | Penagihan & Harga |
| Dapatkan Penggunaan Kunci API | Dapatkan Penggunaan Kunci API |
| Dapatkan Status Tugas | Dapatkan Status Tugas |