guides

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

PoYo Team
11 min read
Share:

Phàn nàn mà nhà phát triển nói tiếng Anh đăng công khai từ 25 đến 27 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. Mô hình nhanh mới nhanh đến mức tự nhận 429 — nhất là khi suy luận tối đa và các phiên Codex chạy song song.

Nhà phát triển đang phàn nàn điều gì: GPT-6.1 Terra ra mắt như một tầng computer-use nhanh hơn và rẻ hơn. Ngay sau đó, người xây sản phẩm nhận HTTP 429 trên Terra / fast-mode và khi suy luận tối đa, trong khi cùng một prompt trên Sol thì không. Vài bài ghi nhận số token dùng khi 429 là không. Điều đó có nghĩa một cửa đồng thời hoặc cửa tốc độ đã kích hoạt trước khi đo. Các phiên Codex song song hỏi cùng một khóa làm tình hình tệ hơn.

PoYo trả lời thế nào: Trang mã lỗi cho 429 một nghĩa — rate_limit_error — và một hành động được khuyến nghị: chờ trước khi thử lại, hoặc xếp hàng yêu cầu. Bắt đầu công bố hạn mức tạo mặc định: tối đa 20 yêu cầu tạo mới mỗi 10 giây, trên mỗi tài khoản. Yêu cầu vượt hạn mức nhận HTTP 429 và không vào hàng đợi. Mô hình chat và media dùng chung một khóa PoYo và được liệt kê trong llms.txt, nên đổi mô hình là đổi chuỗi model, không phải đưa một nhà cung cấp mới vào. Nếu 429 xảy ra liên tục, tài liệu nói bạn có thể liên hệ hỗ trợ để xin hạn mức cao hơn. Việc duyệt được xử lý thận trọng.

Tài liệu nêu không có chuyển dự phòng tự động giữa các nhà cung cấp. Hãy dựng đường lùi trong client. Bắt đầu cũng nói “độ ổn định tổng thể của PoYo có thể thấp hơn một chút so với nhà cung cấp chính thức”.


Q2. “429” của tôi thực ra là trần chi tiêu — lỗi tính phí mặc áo giới hạn tốc độ.

Nhà phát triển đang phàn nàn điều gì: Một bài tóm lại: HTTP 429 không phải một kiểu lỗi. Trên Anthropic, nó có thể là giới hạn tốc độ, giới hạn gia tốc, hoặc trần chi tiêu. 429 do trần chi tiêu thường không có Retry-After, nên chờ mãi không thay đổi gì. Các đội vẫn coi một lần dừng tính phí cứng như việc bóp lưu lượng.

PoYo trả lời thế nào: PoYo tách hai trường hợp rõ ràng trong bảng mã lỗi:

Mãerror.typeÝ nghĩa / việc cần làm
402insufficient_credits_errorSố dư đã hết. Hãy nạp. Thử lại không có ích.
429rate_limit_errorBạn chạm giới hạn tốc độ. Hãy chờ hoặc xếp hàng.
500 / 502 / 503internal_error / upstream_error / service_errorThử lại với lùi theo cấp số nhân.

Bản thân việc tính phí là tín dụng trả trước. Trang chủ nói mua một lần, không đăng ký định kỳ, và tín dụng không hết hạn. Hỏi GET /api/user/balance để đọc credits_amount khi cần một con số đang sống (số dư người dùng). Lời nhắc ở mã lỗi nói rõ: theo dõi tín dụng để tránh 402 trong công việc quan trọng.


Q3. SDK agent của tôi đang đốt cửa sổ giới hạn tốc độ nhanh hơn chat khoảng 1,7 lần — và N agent vẫn dùng chung một trần.

Nhà phát triển đang phàn nàn điều gì: Anthropic thừa nhận một lỗi trong Agents SDK: khi chuyển từ chat sang chế độ agent, hạn mức tốc độ 5 giờ của Claude bị tiêu thụ nhanh hơn dự kiến khoảng 1,7 lần. Riêng biệt, người xây sản phẩm ghi nhận worktree xử lý được xung đột tệp, nhưng mười agent vẫn dùng chung một cơ sở dữ liệu và một giới hạn tốc độ API. Các harness song song vướng nhau trên cùng một khóa.

PoYo trả lời thế nào: Việc tạo trên PoYo được thiết kế bất đồng bộ, nên việc dài không bị buộc vào một lần hết thời gian chờ của cổng. Bắt đầu và tổng quan API nói: gửi một tác vụ, lưu task_id, rồi hỏi trạng thái hoặc nhận webhook. Với tải sản xuất, tài liệu ưu tiên webhook có chữ ký hơn là hỏi thường xuyên. Với 429, hãy chờ hoặc xếp hàng (mã lỗi). Hạn mức tạo mặc định vẫn là 20 yêu cầu mới / 10 giây trên mỗi tài khoản. Phần vượt bị từ chối và không vào hàng đợi.

Để một agent vượt tầm kiểm soát không làm cạn cả tài khoản, hãy dùng các kiểm soát đã ghi trên trang khóa API và Bắt đầu: trần mức dùng theo khóa, theo giờ, theo ngày và tổng. Ảnh, video, nhạc, chat và 3D nằm sau một khóa API thống nhất (llms.txt, trang chủ).

Tài liệu nêu không có chuyển dự phòng tự động giữa các nhà cung cấp. Client của bạn phải xử lý 429 / 5xx và chọn mô hình kế tiếp hoặc đường thử lại.


Q4. Một SaaS nữa lấy khóa AI của tôi — và nhà cung cấp nói khoản chi chưa được phép không được hoàn.

Nhà phát triển đang phàn nàn điều gì: Một lập trình viên báo một khóa API Anthropic bị xâm nhập đã chạy tới 105,94 đô la mức dùng chưa được phép. Hỗ trợ (qua một agent AI) nói mức dùng đã tiêu thụ không được hoàn và đóng việc leo thang. Cùng cửa sổ 48 giờ, các sự cố kiểu OpenCode Console / Railway lại nổi lên, mục tiêu là khóa OpenAI, Anthropic và Google đang được lưu. Hãy xoay trước, rồi đặt một trần chi tiêu cứng.

PoYo trả lời thế nào: Hãy xoay trước. Bí mật đã lộ vẫn là bí mật đã lộ. Sau đó, tài liệu nêu các kiểm soát giới hạn việc một khóa PoYo bị lấy cắp có thể làm:

  • Danh sách IP cho phép. Chỉ cho IP máy chủ đã duyệt dùng một khóa, để khóa sao chép từ biến môi trường không chạy trên máy của người tấn công. Xem trang khóa API và Bắt đầu.
  • Trần mức dùng theo khóa (theo giờ, theo ngày và tổng), để một khóa có trần cứng trước khi bạn nhận ra.
  • Chặn theo người dùng cuối. Gửi header X-End-User-ID rồi bạn có thể chặn một bên gọi lạm dụng trên khóa mà không cần xoay khóa. ID bị chặn trả HTTP 403 với end_user_blocked. Xem 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 bằng khóa đã lộ. Nếu bạn cho rằng một khóa PoYo bị dùng sai, hãy thu hồi và liên hệ hỗ trợ ([email protected]).


Q5. Client AI nên biết khi nào không thử lại — và thử lại video có thể âm thầm nhân đôi hóa đơn.

Nhà phát triển đang phàn nàn điều gì: Thử lại có ích với lỗi tạm thời, nhưng không phải lúc nào cũng đúng. Khi yêu cầu sai định dạng, thông tin xác thực không hợp lệ, hoặc tài khoản không dùng được mô hình, lặp lại cùng một lệnh gọi chỉ thêm áp lực. Với API video, chủ đề ấy hiện ra như sau: bấm thử lại và bạn có thể tạo một tác vụ bị tính phí thứ hai.

PoYo trả lời thế nào: Khớp lỗi với hành động trong mã lỗi:

  • 402 insufficient_credits_error → nạp thêm. Đừng thử lại.
  • 429 rate_limit_error → chờ hoặc xếp hàng.
  • 500 / 502 / 503 → lùi theo cấp số nhân.
  • 401 → sửa khóa. Thử lại cùng thông tin xác thực sai sẽ không có ích (Bắt đầu).

Bắt đầu cũng cảnh báo: hãy coi mỗi lần gửi lại là có thể là công việc trả phí mới. Trước khi gửi lại, hãy xác nhận yêu cầu gốc đã tạo tác vụ hay chưa. Với media, llms.txt và trang chủ nêu tác vụ thất bại không bị tính phí, và tính phí theo đầu ra thành công, giá theo từng mô hình. Hãy ưu tiên callback_url / webhook hơn là hỏi trạng thái dồn dập, để không nhân tải trong lúc chờ (tổng quan API).


Q6. Giá API vẫn thấy đắt quá mức khi đặt cạnh gói đăng ký — và tôi không thấy số dư đang sống trước khi agent đốt hết.

Nhà phát triển đang phàn nàn điều gì: Một câu trả lời nói thẳng: gói đăng ký có cảm giác được trợ giá, còn giá API của OpenAI và Anthropic thì “đắt quá mức”. Các bài khác trong cùng cửa sổ hỏi liệu người ta có biết một prompt đa agent tốn bao nhiêu theo giá API, và nhắc rằng đồng hồ gói ChatGPT / Codex và đồng hồ API không nói chuyện với nhau.

PoYo trả lời thế nào: Ba phần đã ghi trong tài liệu khớp với phàn nàn này:

  1. Tín dụng trả trước, không có đồng hồ đăng ký. Trang chủ mô tả giá theo tín dụng: mua một lần, không đăng ký định kỳ, tín dụng không hết hạn. Bạn trả cho lần tạo thành công. Tác vụ thất bại không bị tính phí (llms.txt).
  2. Một khóa, một số dư. Chat và media dùng chung một tài khoản PoYo. Hỏi GET /api/user/balance để đọc credits_amount (số dư người dùng).
  3. Giá công bố theo từng mô hình. Giá hiện tại nằm trên mỗi trang mô hình / https://poyo.ai/models/<id>/llms.txt và trong chỉ mục danh mục (llms.txt). Hãy xem trước khi gửi công việc trả phí. Đừng suy ra số đô la từ trí nhớ. Lịch sử tác vụ (được mô tả trong Bắt đầu) cho phép xem sau mô hình, đầu vào và trạng thái.

Q7. “Hàm máy chủ” / bot Telegram của tôi ai cũng gọi được — và khóa nằm ở nơi curl tìm thấy.

Nhà phát triển đang phàn nàn điều gì: Các bài bảo mật thực hành vẫn xuất hiện: hãy hạn chế khóa API và đặt hạn mức ngày. Đừng dán khóa nhà cung cấp vào giao diện chat hoặc agent Telegram. Một khóa trong hàm máy chủ mà ai cũng gọi được, không có giới hạn tốc độ theo người dùng và trần chi tiêu, là một thẻ tín dụng cho người tìm ra URL.

PoYo trả lời thế nào: Bắt đầu nói rõ: không bao giờ để lộ khóa API trong mã frontend (trình duyệt, ứng dụng di động, kho công khai). Hãy coi khóa là bí mật, giữ nó trên máy chủ của bạn, và dùng các kiểm soát đã được ghi cho khóa sản xuất:

  • Danh sách IP cho phép và trần theo khóa, theo giờ / theo ngày / tổng trên trang khóa API.
  • Yêu cầu X-End-User-ID, rồi chặn 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).
  • Xử lý rõ 401, 402 và 429 trước khi đưa vào sản xuất (Bắt đầu, mã lỗi).

Bảng tra nhanh

Phàn nànPoYo ghi ở đâu
429 của Terra / Codex khi ra mắt nhanhMã lỗi · Bắt đầu: giới hạn tốc độ · llms.txt
Trần chi tiêu đội lốt 429Mã lỗi: 402 và 429 · Trang chủ: tín dụng · API số dư
SDK agent / agent song song đốt một trầnBắt đầu: bất đồng bộ và 429 · Tổng quan API · Trần khóa API
Khóa bị lộ và chi tiêu chưa được phépTrang khóa API · Bắt đầu · X-End-User-ID
Thử lại mù / tác vụ video bị làm hai lầnMã lỗi · Bắt đầu: thử lại = công việc trả phí mới · llms.txt: thất bại không tính phí
API đắt so với gói đăng ký / số dư mờTrang chủ: tín dụng · API số dư · Giá trong llms.txt
Khóa trong bot / giao diện chat / hàm máy chủBắt đầu: không để lộ khóa · Trang khóa API · X-End-User-ID
Share: