guides

2026-10-28: 7 keluhan API yang kami dengar hari ini

PoYo Team
9 min read
Share:

Keluhan yang diposting secara terbuka oleh pengembang berbahasa Inggris antara 26 dan 28 Oktober 2026, diringkas di sini beserta tautan ke posting asli. Setiap jawaban hanya memakai apa yang dikatakan situs publik dan dokumentasi PoYo hari ini, dan menautkan halaman sumbernya. Jika dokumentasi tidak membahas sesuatu, kami menyatakannya.


Q1. Claude Code menabrak dinding pemakaian di tengah refactor — dan masih belum ada jalur yang bersih untuk «kembali ke kunci API saya».

Apa yang dikeluhkan pengembang: Linimasa 27–28 Oktober penuh tangkapan layar batas pemakaian Claude Code dan Codex yang diletakkan berdampingan. Pembangun bertanya apakah Claude Code dapat kembali ke kunci API setelah batas langganan tercapai (@irl_danB), bercanda bahwa menabrak batas di tengah refactor adalah «lupa menyimpan» yang baru (@automater_ai), dan membandingkan tingkat 20 dolar yang terasa tidak berguna pada satu tumpukan sementara langganan Plus yang lain tidak pernah tersandung (@mozdca, @LeoZhang57).

Bagaimana PoYo menjawab: PoYo adalah kredit prabayar, bukan jendela langganan 5 jam atau mingguan. Beranda menjelaskan pembelian kredit sekali, tanpa langganan berulang, dan kredit yang tidak kedaluwarsa. Anda membayar generasi yang berhasil. llms.txt menyatakan tugas yang gagal tidak ditagih. Obrolan dan media berbagi satu kunci API dan satu saldo. Untuk credits_amount yang hidup, polling GET /api/user/balance (saldo pengguna).

Saat saldo habis, PoYo mengembalikan 402 insufficient_credits_error, bukan jendela pemakaian bergulir yang berpakaian pembatasan (kode kesalahan). Tidak ada fitur produk terdokumentasi berupa pengalihan «langganan → kunci API», karena penagihan sudah berbasis kredit. Batasi agen yang lepas kendali dengan batas pemakaian per kunci, per jam, per hari, dan total, di halaman kunci API (Memulai).


Q2. «429» Claude Code adalah tiga pesan yang berbeda — menunggu terus hanya membantu salah satunya.

Apa yang dikeluhkan pengembang: Sebuah utas pemecahan masalah menyebut bahwa Claude Code dapat menampilkan tiga kegagalan berbentuk 429: tunggu pengaturan ulang, coba lagi sebentar lagi, atau periksa kunci API. Masing-masing perlu perbaikan yang berbeda (@aiparabellum). Terpisah, pembangun bertanya apakah masalah batas laju pada perkakas agen Anthropic sudah diperbaiki (@XavierDelon, @GeorgeMathew_).

Bagaimana PoYo menjawab: Kode kesalahan kami menaruh penagihan dan batas laju pada angka yang berbeda:

Kodeerror.typeArti / yang perlu dilakukan
401authentication_errorKunci tidak valid atau tidak ada. Perbaiki kredensial. Jangan coba lagi kunci yang sama yang buruk (Memulai).
402insufficient_credits_errorSaldo habis. Isi ulang. Mencoba lagi tidak akan membantu.
429rate_limit_errorBatas laju. Tunggu atau antrekan.
500 / 502 / 503internal_error / upstream_error / service_errorPenundaan eksponensial.

Throughput pembuatan bawaan didokumentasikan hingga 20 permintaan baru per 10 detik per akun. Kelebihan mendapat HTTP 429 dan tidak masuk antrean (Memulai). Pemecahan masalah integrasi juga mengatakan: hormati Retry-After pada batas laju, dan jangan mencoba ulang secara buta pengiriman berbayar sampai Anda tahu apakah task_id sudah dibuat (pemecahan masalah).

Dokumentasi menjelaskan tidak ada pengalihan otomatis antar penyedia hulu. Bangun itu di klien Anda.


Q3. Setiap kunci API yang pernah saya tempel di obrolan agen masih ada di log proyek.

Apa yang dikeluhkan pengembang: Setelah utas tentang log proyek Claude, satu balasan langsung ke risikonya: setiap kunci API yang pernah Anda tempel di obrolan juga ada di log itu. Grep sk- di ~/.claude/projects dan rotasi apa pun yang muncul (@wazX_7). Posting di dekatnya mengulang kebersihan yang sama: perlakukan kunci AI seperti kredensial root (@RuntimeAI_io), dan berhenti memberi setiap agen satu kunci bersama tanpa sakelar matikan (@RohanBhanotAI).

Bagaimana PoYo menjawab: Memulai tegas: jangan pernah membuka kunci API di kode frontend, aplikasi seluler, atau repositori publik, dan perlakukan sebagai rahasia. Simpan kunci di server Anda. Setelah penempelan atau dugaan kebocoran:

  1. Cabut / rotasi kunci di halaman kunci API.
  2. Daftar izin IP, supaya kunci yang disalin hanya bekerja dari IP server yang disetujui.
  3. Plafon per kunci, per jam / per hari / total, supaya kebocoran punya langit-langit.
  4. Kirim X-End-User-ID pada pembuatan dan obrolan asli. Blokir satu pemanggil yang menyalahgunakan dengan HTTP 403 end_user_blocked tanpa merotasi seluruh kunci (Identifikasi pengguna akhir).

Dokumen publik kami tidak menjanjikan pengembalian dana untuk pemakaian yang dibuat dengan kunci bocor. Hubungi [email protected] jika Anda yakin sebuah kunci PoYo disalahgunakan.


Q4. Kunci agregator yang saya lupakan masih dompet agen — pelanggaran host mengubah kredensial yang menganggur menjadi pekerjaan 500 langkah.

Apa yang dikeluhkan pengembang: Sebuah posting memperingatkan bahwa kunci OpenRouter yang terlupakan masih dompet agen: pelanggaran bergaya Railway menaruh kunci yang menganggur pada daftar pencabutan, dan satu kunci sudah membiayai pekerjaan agen 500 langkah sementara dasbor menunjukkan lalu lintas nol sampai saat itu. Perbaikan yang disebut: plafon belanja, kunci berumur pendek, dan jangan menaruh token penyedia pada host yang sudah tidak Anda awasi (@neiro_go_neiro). Balasan lain mengaitkan pola yang sama dengan penyedia yang masih mencabut kunci berminggu-minggu setelah pelanggaran (@Kenz_1604).

Bagaimana PoYo menjawab: Kunci yang menganggur pada host yang ditinggalkan adalah masalah rahasia di sisi klien. Kendali yang didokumentasikan PoYo membatasi radius setelah rahasia ada:

  • Buat kunci terpisah per lingkungan / harness, masing-masing dengan plafon pemakaian per jam, per hari, dan total (halaman kunci API, Memulai).
  • Nyalakan daftar izin IP untuk kunci produksi.
  • Utamakan X-End-User-ID supaya Anda dapat memblokir satu pemanggil tanpa menghapus kunci (Identifikasi pengguna akhir).
  • Awasi saldo hidup dengan GET /api/user/balance (saldo pengguna) dan riwayat tugas di dasbor (Memulai).

Hapus kunci yang tidak lagi Anda pakai. Dokumentasi tidak menulis kedaluwarsa otomatis untuk kunci yang tidak terpakai, dan tidak menulis SLA pengembalian dana untuk belanja yang didorong pelanggaran. Katakan itu, lalu rotasi.


Q5. Saya memasang batas belanja AI yang keras — lalu seseorang mendapat kuncinya dan melewatinya dalam semalam.

Apa yang dikeluhkan pengembang: Seorang pembangun memasang batas tagihan AI sebesar 25 dolar. Seseorang mendapat kunci API dan menjalankannya sampai 55 dolar dalam satu malam (@twentyonemilll). Temanya sejalan dengan utas OpenRouter yang lebih lama: menonaktifkan tidak cukup, dan hanya penghapusan kunci secara penuh yang menghentikan pengurasan. Jendela 28 Oktober masih menghasilkan keluhan yang sama: plafon ada, kebocoran tetap menyakitkan.

Bagaimana PoYo menjawab: Plafon hanya membantu jika diberlakukan pada kredensial yang disusupi, bukan hanya pada anggaran lunak di dasbor. Di PoYo:

  • Pasang plafon pemakaian per kunci, per jam / per hari / total, pada setiap kunci produksi (Memulai, halaman kunci API).
  • Gabungkan dengan daftar izin IP supaya kunci gagal dari jaringan penyerang.
  • Pakai X-End-User-ID plus pemblokiran untuk aplikasi multi-penyewa (Identifikasi pengguna akhir).
  • Pada 402, berhenti. Itu berarti kredit habis (kode kesalahan). Polling saldo sebelum batch besar (saldo pengguna).

Jika sebuah kunci mungkin sudah keluar, hapus atau cabut. Jangan hanya menurunkan peringatan yang lunak. Dokumen publik tidak mengklaim pengembalian dana untuk belanja kunci yang bocor.


Q6. Mendapat kunci API Google begitu menyulitkan sehingga «pakai saja agregator» menjadi pilihan bawaan.

Apa yang dikeluhkan pengembang: Seorang pengembang berkata ia hanya akan mencoba model Google jika proses pendaftaran kunci API diperbaiki. Sampai saat itu, hanya OpenRouter (@sandipb). Posting di dekatnya terus membingkai agregator sebagai dompet pembayaran dan pengalih model untuk agen (@tomcritchlow), sementara yang lain masih mengurus belasan kunci vendor hanya untuk menguji (@sunwei57247249).

Bagaimana PoYo menjawab: PoYo dibangun sebagai satu kunci terpadu untuk gambar, video, musik, 3D, dan obrolan (llms.txt, beranda). Buat kunci di halaman kunci API. Media memakai POST /api/generate/submit yang asinkron ditambah status atau webhook. Obrolan memakai titik akhir yang kompatibel dengan OpenAI, Claude Messages, atau asli Gemini, sesuai dokumentasi tiap model. Berganti model adalah mengubah string model (dan bentuk titik akhir yang cocok untuk obrolan), bukan alur penerimaan vendor yang baru.

Skema masukan dan harga terkini ada di https://poyo.ai/models/<id>/llms.txt dan di indeks katalog (llms.txt). Dokumentasi tidak mengklaim PoYo adalah terusan akun resmi tiap laboratorium. Dokumentasi juga mengatakan stabilitas keseluruhan mungkin sedikit lebih rendah daripada penyedia resmi (Memulai). Pilih pertukaran itu secara sadar.


Q7. Langganan video 59 dolar adalah jalan masuk yang mahal jika saya hanya merilis beberapa klip — dan percobaan ulang dapat mengada-adakan tagihan kedua.

Apa yang dikeluhkan pengembang: Pembuat membandingkan paket alat video bulanan dengan API bayar per klip. Jika Anda hanya membuat beberapa video AI sebulan, paket 59 dolar dapat menjadi jalur yang mahal, sementara API menagih per klip dan agen pemrograman dapat menggerakkannya (@aliteqai). Nyeri API yang terkait: unduhan video yang sudah selesai tertahan sampai penyelesaian penagihan (@MariaOnchainDev), dan kekhawatiran yang tetap bahwa percobaan ulang yang buta menciptakan pekerjaan berbayar kedua.

Bagaimana PoYo menjawab: Video di PoYo dihargai dengan kredit per keluaran yang berhasil, model per model. Katalog video ada di llms.txt (Sora 2, Veo 3.1, Kling, Wan, Seedance, Hailuo, dan lainnya). Alurnya adalah API asinkron terpadu: kirim, lalu polling status atau atur callback_url (Memulai, webhook). Beranda dan llms.txt sama-sama menyatakan tugas yang gagal tidak ditagih.

Sebelum Anda menghantam percobaan ulang pada pekerjaan video yang lambat: Memulai memperingatkan bahwa setiap pengiriman ulang dapat menjadi pekerjaan berbayar yang baru. Pastikan apakah permintaan asli sudah membuat task_id. Utamakan webhook daripada polling yang agresif. Pada 402, 429, dan 5xx, ikuti tabel kode kesalahan. Jangan memperlakukan penghentian kredit seperti batas laju.


Peta singkat

KeluhanDi mana PoYo mendokumentasikannya
Dinding plafon pemakaian / tidak ada pengalihan dari langganan ke APIBeranda: kredit · API saldo · Kode kesalahan: 402 · Plafon kunci API
429 yang berarti tiga kegagalan berbedaKode kesalahan: 401 / 402 / 429 / 5xx · Memulai: batas laju · Pemecahan masalah
Kunci yang ditempel ke log agenMemulai: jangan membuka kunci · Halaman kunci API · X-End-User-ID
Kunci agregator yang menganggur setelah pelanggaran hostPlafon kunci API · Daftar izin IP · Saldo dan riwayat tugas · cabut kunci yang tidak dipakai
Plafon belanja ditembus kunci yang bocorPlafon per kunci · Daftar izin IP · X-End-User-ID · Penanganan 402
Pendaftaran kunci penyedia yang menyulitkan / kunci yang menyebarSatu kunci PoYo · Katalog llms.txt · llms.txt per model
Langganan video dibanding harga per klip dan penagihan percobaan ulangKatalog video · Kirim/status asinkron · Gagal tidak ditagih · Coba lagi = pekerjaan berbayar baru
Share: