guides

2026-10-28: 7 phàn nàn về API mà chúng tôi nghe hôm nay

PoYo Team
12 min read
Share:

Phàn nàn mà nhà phát triển nói tiếng Anh đăng công khai từ 26 đến 28 tháng 10 năm 2026, được tóm tắt ở đây kèm liên kết bài gốc. Mỗi câu trả lời chỉ dùng những gì trang công khai và tài liệu của PoYo nói hôm nay, và trỏ về trang nguồn. Khi tài liệu không đề cập một điểm, chúng tôi nói rõ.


Q1. Claude Code đụng tường sử dụng giữa lúc tái cấu trúc — và vẫn chưa có đường sạch để «quay về khóa API của tôi».

Nhà phát triển đang phàn nàn điều gì: Dòng thời gian ngày 27–28 tháng 10 đầy ảnh chụp giới hạn sử dụng của Claude Code và Codex đặt cạnh nhau. Người xây sản phẩm hỏi Claude Code có thể lùi về một khóa API khi hết hạn mức gói đăng ký hay không (@irl_danB), đùa rằng đụng hạn mức giữa lúc tái cấu trúc là kiểu «quên lưu» mới (@automater_ai), và so một bậc 20 đô la gần như vô dụng trên một ngăn xếp với gói Plus khác chưa bao giờ chạm hạn mức (@mozdca, @LeoZhang57).

PoYo trả lời thế nào: PoYo là tín dụng trả trước, không phải cửa sổ đăng ký 5 giờ hay theo tuần. Trang chủ mô tả mua tín dụng một lần, không có đăng ký định kỳ, và tín dụng không hết hạn. Bạn trả cho lần tạo thành công. llms.txt nói tác vụ thất bại không bị tính phí. Chat và media dùng chung một khóa API và một số dư. Khi cần credits_amount theo thời gian thực, hãy hỏi GET /api/user/balance (số dư người dùng).

Khi số dư hết, PoYo trả 402 insufficient_credits_error, không phải một cửa sổ sử dụng trượt được khoác áo bóp lưu lượng (mã lỗi). Không có tính năng sản phẩm đã ghi về chuyển «đăng ký → khóa API», vì cách tính phí vốn đã theo tín dụng. Hãy đặt trần cho agent vượt tầm với hạn mức sử dụng theo khóa, theo giờ, theo ngày và tổng, trên trang khóa API (Bắt đầu).


Q2. «429» của Claude Code là ba thông báo khác nhau — chờ mãi chỉ giúp một trong số đó.

Nhà phát triển đang phàn nàn điều gì: Một chuỗi chẩn đoán chỉ ra Claude Code có thể hiện ba lỗi mang hình 429: chờ đặt lại, thử lại một lát, hoặc kiểm tra khóa API. Mỗi cái cần một cách sửa khác nhau (@aiparabellum). Riêng biệt, người xây sản phẩm hỏi các vấn đề giới hạn tốc độ trong công cụ agent của Anthropic đã được sửa chưa (@XavierDelon, @GeorgeMathew_).

PoYo trả lời thế nào: Mã lỗi của chúng tôi giữ tính phí và giới hạn tốc độ trên các số khác nhau:

Mãerror.typeÝ nghĩa / việc cần làm
401authentication_errorKhóa không hợp lệ hoặc thiếu. Sửa thông tin xác thực. Đừng thử lại cùng khóa sai (Bắt đầu).
402insufficient_credits_errorSố dư đã hết. Hãy nạp. Thử lại sẽ không giúp.
429rate_limit_errorGiới hạn tốc độ. Hãy chờ hoặc xếp hàng.
500 / 502 / 503internal_error / upstream_error / service_errorLùi theo cấp số nhân.

Thông lượng tạo mặc định được ghi là tối đa 20 yêu cầu mới mỗi 10 giây trên mỗi tài khoản. Phần vượt nhận HTTP 429 và không vào hàng đợi (Bắt đầu). Khắc phục sự cố tích hợp cũng nói: tôn trọng Retry-After khi gặp giới hạn tốc độ, và đừng thử lại mù một lần gửi có tính phí cho đến khi biết đã tạo task_id hay chưa (khắc phục sự cố).

Tài liệu mô tả không có chuyển dự phòng tự động giữa các nhà cung cấp thượng nguồn. Hãy dựng điều đó trong máy khách của bạn.


Q3. Mọi khóa API tôi từng dán vào chat của agent vẫn nằm trong nhật ký dự án.

Nhà phát triển đang phàn nàn điều gì: Sau một chuỗi về nhật ký dự án Claude, một câu trả lời đi thẳng vào rủi ro: mọi khóa API bạn từng dán vào chat cũng nằm trong những nhật ký đó. Hãy grep sk- trong ~/.claude/projects và xoay những gì xuất hiện (@wazX_7). Các bài gần đó nhắc cùng một thói quen: hãy coi khóa AI như thông tin xác thực root (@RuntimeAI_io), và đừng đưa cho mọi agent một khóa dùng chung không có công tắc dừng (@RohanBhanotAI).

PoYo trả lời thế nào: Bắt đầu nói thẳng: không bao giờ để lộ khóa API trong mã frontend, ứng dụng di động hoặc kho công khai, và hãy coi nó là bí mật. Giữ khóa trên máy chủ của bạn. Sau khi dán hoặc nghi bị lộ:

  1. Thu hồi / xoay khóa trên trang khóa API.
  2. Danh sách IP cho phép, để khóa bị sao chép chỉ chạy từ IP máy chủ đã duyệt.
  3. Trần theo khóa, theo giờ / theo ngày / tổng, để một lần lộ có trần.
  4. Gửi X-End-User-ID trên lần tạo và chat gốc. Chặn một bên gọi lạm dụng bằng HTTP 403 end_user_blocked mà không xoay cả khóa (Nhận dạng người dùng cuối).

Tài liệu công khai không hứa hoàn cho mức dùng phát sinh từ khóa bị lộ. Hãy viết tới [email protected] nếu bạn cho rằng một khóa PoYo bị dùng sai.


Q4. Khóa tổng hợp tôi quên vẫn là ví của agent — một lần xâm nhập máy chủ biến thông tin xác thực để không thành việc 500 bước.

Nhà phát triển đang phàn nàn điều gì: Một bài cảnh báo rằng khóa OpenRouter bị quên vẫn là ví của agent: một lần xâm nhập kiểu Railway đưa khóa để không vào danh sách cần thu hồi, và một khóa đã trả cho việc của agent dài 500 bước trong khi bảng điều khiển đến lúc đó cho thấy lưu lượng bằng không. Cách xử lý được nêu: trần chi tiêu, khóa sống ngắn, và không để token nhà cung cấp trên máy chủ bạn đã ngừng theo dõi (@neiro_go_neiro). Một câu trả lời khác nối cùng kiểu đó với các nhà cung cấp vẫn thu hồi khóa nhiều tuần sau xâm nhập (@Kenz_1604).

PoYo trả lời thế nào: Khóa để không trên máy chủ bị bỏ là vấn đề bí mật phía máy khách. Các kiểm soát mà PoYo đã ghi giới hạn bán kính khi bí mật đã tồn tại:

  • Tạo khóa riêng cho từng môi trường / harness, mỗi khóa có trần sử dụng theo giờ, theo ngày và tổng (trang khóa API, Bắt đầu).
  • Bật danh sách IP cho phép cho khóa sản xuất.
  • Ưu tiên X-End-User-ID để có thể chặn một bên gọi mà không xóa khóa (Nhận dạng người dùng cuối).
  • Xem số dư theo thời gian thực bằng GET /api/user/balance (số dư người dùng) và lịch sử tác vụ trên bảng điều khiển (Bắt đầu).

Hãy xóa khóa bạn không còn dùng. Tài liệu không ghi khóa không dùng tự hết hạn, cũng không ghi SLA hoàn tiền cho chi tiêu do xâm nhập gây ra. Hãy nói rõ điều đó, rồi xoay khóa.


Q5. Tôi đặt một trần chi tiêu AI cứng — rồi ai đó lấy được khóa và vượt qua nó chỉ trong một đêm.

Nhà phát triển đang phàn nàn điều gì: Một người xây sản phẩm đặt giới hạn hóa đơn AI ở 25 đô la. Ai đó lấy được khóa API và chạy tới 55 đô la trong một đêm (@twentyonemilll). Chủ đề khớp các chuỗi OpenRouter cũ hơn: tắt chưa đủ, chỉ xóa hẳn khóa mới dừng được dòng chảy. Cửa sổ ngày 28 tháng 10 vẫn tạo ra cùng một phàn nàn: trần đã có, lần lộ vẫn gây thiệt.

PoYo trả lời thế nào: Trần chỉ có ích khi được cưỡng chế trên thông tin xác thực đã bị xâm phạm, không chỉ trên một ngân sách mềm của bảng điều khiển. Trên PoYo:

  • Đặt trần sử dụng theo khóa, theo giờ / theo ngày / tổng, trên mọi khóa sản xuất (Bắt đầu, trang khóa API).
  • Kết hợp danh sách IP cho phép để khóa thất bại từ mạng của bên tấn công.
  • Với ứng dụng nhiều bên thuê, dùng X-End-User-ID cộng chặn (Nhận dạng người dùng cuối).
  • Gặp 402 thì dừng. Điều đó có nghĩa tín dụng đã hết (mã lỗi). Hãy hỏi số dư trước các lô lớn (số dư người dùng).

Nếu một khóa có thể đã ra ngoài, hãy xóa hoặc thu hồi. Đừng chỉ hạ một cảnh báo mềm. Tài liệu công khai không tuyên bố hoàn tiền cho chi tiêu từ khóa bị lộ.


Q6. Lấy khóa API của Google nặng đến mức «cứ dùng bên tổng hợp» thành lựa chọn mặc định.

Nhà phát triển đang phàn nàn điều gì: Một lập trình viên nói sẽ chỉ thử mô hình Google nếu quy trình đăng ký khóa API được sửa. Trước đó chỉ dùng OpenRouter (@sandipb). Các bài gần đó tiếp tục coi bên tổng hợp là ví thanh toán và chỗ đổi mô hình cho agent (@tomcritchlow), trong khi người khác vẫn cầm một tá khóa nhà cung cấp chỉ để thử (@sunwei57247249).

PoYo trả lời thế nào: PoYo được dựng thành một khóa thống nhất cho ảnh, video, nhạc, 3D và chat (llms.txt, trang chủ). Tạo khóa tại trang khóa API. Media dùng POST /api/generate/submit bất đồng bộ, cộng trạng thái hoặc webhook. Chat dùng điểm cuối tương thích OpenAI, Claude Messages, hoặc gốc Gemini, theo tài liệu từng mô hình. Đổi mô hình là đổi chuỗi model (và dạng điểm cuối khớp với chat), không phải một quy trình đưa nhà cung cấp mới vào.

Lược đồ đầu vào và giá hiện tại nằm ở https://poyo.ai/models/<id>/llms.txt và trong chỉ mục danh mục (llms.txt). Tài liệu không tuyên bố PoYo là đường xuyên qua tài khoản chính thức của từng phòng thí nghiệm. Tài liệu cũng nói độ ổn định tổng thể có thể thấp hơn một chút so với nhà cung cấp chính thức (Bắt đầu). Hãy chọn đánh đổi đó một cách có chủ đích.


Q7. Gói video 59 đô la là lối vào đắt nếu tôi chỉ xuất vài clip — và thử lại có thể tạo ra hóa đơn thứ hai.

Nhà phát triển đang phàn nàn điều gì: Người sáng tạo so gói công cụ video theo tháng với API tính theo clip. Nếu một tháng bạn chỉ làm vài video AI, gói 59 đô la có thể là đường đắt, trong khi API tính theo clip và agent lập trình có thể điều khiển nó (@aliteqai). Nỗi đau API liên quan: tải video đã xong phải chờ quyết toán tính phí (@MariaOnchainDev), và nỗi lo thường trực rằng thử lại mù sẽ tạo một tác vụ bị tính phí thứ hai.

PoYo trả lời thế nào: Video trên PoYo được định giá bằng tín dụng theo đầu ra thành công, từng mô hình một. Danh mục video nằm trong llms.txt (Sora 2, Veo 3.1, Kling, Wan, Seedance, Hailuo, và các mô hình khác). Quy trình là API bất đồng bộ thống nhất: gửi, rồi hỏi trạng thái hoặc đặt callback_url (Bắt đầu, webhook). Trang chủ và llms.txt đều nói tác vụ thất bại không bị tính phí.

Trước khi dồn thử lại trên một việc video chậm: Bắt đầu cảnh báo mỗi lần gửi lại có thể là công việc trả phí mới. Hãy xác nhận yêu cầu gốc đã tạo task_id hay chưa. Ưu tiên webhook hơn hỏi dồn dập. Với 402, 429 và 5xx, hãy theo bảng mã lỗi. Đừng coi một lần dừng tín dụng như giới hạn tốc độ.


Bảng tra nhanh

Phàn nànPoYo ghi ở đâu
Tường trần sử dụng / không có chuyển từ đăng ký sang APITrang chủ: tín dụng · API số dư · Mã lỗi: 402 · Trần khóa API
429 mang ba lỗi khác nhauMã lỗi: 401 / 402 / 429 / 5xx · Bắt đầu: giới hạn tốc độ · Khắc phục sự cố
Khóa bị dán vào nhật ký agentBắt đầu: không để lộ khóa · Trang khóa API · X-End-User-ID
Khóa tổng hợp để không sau khi máy chủ bị xâm nhậpTrần khóa API · Danh sách IP cho phép · Số dư và lịch sử tác vụ · thu hồi khóa không dùng
Trần chi tiêu bị khóa lộ phá vỡTrần theo khóa · Danh sách IP cho phép · X-End-User-ID · Xử lý 402
Lấy khóa nhà cung cấp rất nặng / khóa lan raMột khóa PoYo · Danh mục llms.txt · llms.txt theo mô hình
Gói video so với giá theo clip và tính phí khi thử lạiDanh mục video · Gửi/trạng thái bất đồng bộ · Thất bại không tính phí · Thử lại = công việc trả phí mới
Share: