guides

2026-10-27: 오늘 들은 API 불만 7가지

PoYo Team
7 min read
Share:

2026년 10월 25일부터 27일까지 영어권 개발자가 공개적으로 올린 불만을 원문 링크와 함께 옮겼습니다. 각 답은 오늘 PoYo 공개 사이트와 문서에 적힌 내용만 사용하고, 그 페이지로 연결합니다. 문서가 다루지 않는 부분은 그렇게 밝힙니다.


Q1. 새 고속 모델은 너무 빨라서 스스로 429에 걸린다. 최대 추론과 병렬 Codex 세션에서 특히 그렇다.

개발자가 불만을 말하는 부분: GPT-6.1 Terra는 더 빠르고 더 저렴한 computer-use 계층으로 나왔습니다. 개발자는 곧바로 Terra / fast-mode와 최대 추론에서 HTTP 429를 만났습니다. 같은 프롬프트를 Sol에 넣으면 그렇지 않았습니다. 여러 글은 429에서 사용된 토큰이 0이라고 적었습니다. 계량 전에 동시성 또는 속도 게이트가 동작했다는 뜻입니다. 같은 키를 폴링하는 병렬 Codex 세션이 상황을 더 나쁘게 만들었습니다.

PoYo의 답: 오류 코드 페이지는 429에 하나의 의미, rate_limit_error와 하나의 권장 동작을 줍니다. 재시도 전에 기다리거나, 요청을 대기열에 넣으십시오. 시작하기가 공개한 기본 생성 한도는 계정당 10초에 새 생성 요청 20건까지입니다. 그 한도를 넘는 요청은 HTTP 429를 받고 대기열에 들어가지 않습니다. 채팅과 미디어 모델은 PoYo 키 하나를 공유하며 llms.txt에 있습니다. 모델을 바꾸는 일은 model 문자열을 바꾸는 일이며, 새 공급자를 들이는 일이 아닙니다. 429가 계속되면 문서는 지원에 더 높은 한도를 문의할 수 있다고 합니다. 승인은 신중하게 처리됩니다.

문서는 공급자 사이의 자동 장애 조치가 없다고 적습니다. 폴백은 클라이언트에 넣으십시오. 시작하기는 PoYo의 “전체 안정성이 공식 공급자보다 약간 낮을 수 있다”고도 합니다.


Q2. 내 “429”는 사실 지출 한도였다. 청구 오류가 속도 제한의 옷을 입고 있다.

개발자가 불만을 말하는 부분: 한 글은 이렇게 정리했습니다. HTTP 429는 하나의 실패 방식이 아닙니다. Anthropic에서는 속도 제한, 가속 제한, 지출 한도 중 하나일 수 있습니다. 지출 한도의 429에는 Retry-After가 없는 경우가 많아, 끝없이 기다려도 달라지지 않습니다. 팀은 단단한 청구 중단을 스로틀처럼 계속 다룹니다.

PoYo의 답: PoYo는 오류 코드 표에서 두 경우를 나눕니다.

코드error.type의미 / 할 일
402insufficient_credits_error잔액이 없습니다. 충전하십시오. 재시도는 도움이 되지 않습니다.
429rate_limit_error속도 제한에 걸렸습니다. 기다리거나 대기열에 넣으십시오.
500 / 502 / 503internal_error / upstream_error / service_error지수 백오프로 재시도하십시오.

청구 자체는 선불 크레딧입니다. 홈페이지는 일회 구매이고 반복 구독은 없으며, 크레딧은 만료되지 않는다고 적습니다. 실시간 숫자가 필요하면 GET /api/user/balance를 폴링해 credits_amount를 읽으십시오(사용자 잔액). 오류 코드의 안내는 분명합니다. 중요한 작업 중에 402를 피하려면 크레딧을 감시하십시오.


Q3. 에이전트 SDK가 속도 제한 창을 채팅보다 약 1.7배 빨리 태운다. N개의 에이전트는 여전히 한도 하나를 나눈다.

개발자가 불만을 말하는 부분: Anthropic은 Agents SDK의 결함을 인정했습니다. 채팅에서 에이전트 모드로 바꾸면 Claude의 5시간 속도 제한을 예상보다 약 1.7배 빨리 소비했습니다. 별도로 개발자는, worktree가 파일 충돌은 고치지만 에이전트 열 개는 여전히 데이터베이스 하나와 API 속도 제한 하나를 공유한다고 적었습니다. 병렬 harness는 같은 키 위에서 서로 걸립니다.

PoYo의 답: PoYo의 생성은 비동기로 설계되어, 긴 작업이 단일 게이트웨이 시간 초과에 묶이지 않습니다. 시작하기와 API 개요는 작업을 제출하고 task_id를 저장한 뒤, 상태를 폴링하거나 webhook을 받으라고 합니다. 프로덕션 부하에서 문서는 잦은 폴링보다 서명된 webhook을 선호합니다. 429에서는 기다리거나 대기열에 넣으십시오(오류 코드). 기본 생성 한도는 여전히 계정당 10초에 새 요청 20건이며, 초과분은 거부되고 대기열에 들어가지 않습니다.

하나의 폭주한 에이전트가 계정 전체를 비우지 않도록, API 키 페이지와 시작하기에 적힌 제어를 쓰십시오. 키별 시간, 일, 누적 사용 한도입니다. 이미지, 영상, 음악, 채팅, 3D는 통합 API 키 하나 뒤에 있습니다(llms.txt, 홈페이지).

문서는 공급자 사이의 자동 장애 조치가 없다고 적습니다. 클라이언트가 429 / 5xx를 처리하고, 다음 모델이나 재시도 경로를 골라야 합니다.


Q4. 또 다른 SaaS가 내 AI 키를 가져갔다. 공급자는 무단 지출을 환불하지 않는다고 했다.

개발자가 불만을 말하는 부분: 한 개발자는 침해된 Anthropic API 키가 무단 사용으로 105.94달러에 이르렀다고 보고했습니다. 지원(AI 에이전트를 통해)은 이미 소비된 사용량은 환불되지 않는다고 하고 상향을 닫았습니다. 같은 48시간 창에서는 OpenCode Console / Railway 형태의 침해가 되풀이되었고, 저장된 OpenAI, Anthropic, Google 키가 대상이었습니다. 먼저 교체하고, 그다음 단단한 지출 천장을 두십시오.

PoYo의 답: 먼저 교체하십시오. 새어 나간 비밀은 새어 나간 비밀입니다. 그다음, 문서는 도난당한 PoYo 키가 할 수 있는 일을 제한하는 제어를 적습니다.

  • IP 허용 목록. 승인한 서버 IP만 그 키를 쓰게 할 수 있습니다. 환경 변수에서 복사된 키는 공격자의 머신에서 동작하지 않습니다. API 키 페이지와 시작하기를 보십시오.
  • 키별 사용 한도(시간, 일, 누적). 알아차리기 전에 키 하나에 단단한 천장을 둡니다.
  • 엔드유저 단위 차단. X-End-User-ID 헤더를 보내면, 키를 교체하지 않고 그 키의 남용 호출자 한 명을 막을 수 있습니다. 차단된 ID는 HTTP 403과 end_user_blocked를 반환합니다. 엔드유저 식별을 보십시오.

공개 문서는 유출된 키로 발생한 사용량에 대한 환불을 약속하지 않습니다. PoYo 키가 오용되었다고 보면 키를 폐기하고 지원([email protected])에 연락하십시오.


Q5. AI 클라이언트는 언제 재시도하지 않을지 알아야 한다. 영상 재시도는 청구를 조용히 두 배로 만들 수 있다.

개발자가 불만을 말하는 부분: 재시도는 일시적 실패에는 도움이 되지만, 어디에나 맞지는 않습니다. 요청 형식이 잘못되었거나, 자격 증명이 유효하지 않거나, 계정에서 그 모델을 쓸 수 없을 때 같은 호출을 반복하면 압력만 더합니다. 영상 API에서 같은 주제는 “재시도를 누르면 청구되는 두 번째 작업이 생길 수 있다”로 나타납니다.

PoYo의 답: 오류 코드에서 오류와 동작을 맞추십시오.

  • 402 insufficient_credits_error → 충전하십시오. 재시도하지 마십시오.
  • 429 rate_limit_error → 기다리거나 대기열에 넣으십시오.
  • 500 / 502 / 503 → 지수 백오프.
  • 401 → 키를 고치십시오. 같은 잘못된 자격 증명을 다시 보내도 도움이 되지 않습니다(시작하기).

시작하기는 이렇게도 경고합니다. 제출 재시도는 모두 새로운 유료 작업일 수 있다고 보고, 다시 제출하기 전에 원래 요청이 작업을 만들었는지 확인하십시오. 미디어에 대해 llms.txt와 홈페이지는 실패한 작업은 청구되지 않으며, 청구는 성공한 출력마다, 모델마다 가격이 매겨진다고 적습니다. 기다리는 동안 부하를 늘리지 않도록, 공격적인 상태 폴링보다 callback_url / webhook을 우선하십시오(API 개요).


Q6. API 가격은 구독 옆에 두면 여전히 터무니없이 비싸다. 에이전트가 태우기 전에 실시간 잔액이 보이지 않는다.

개발자가 불만을 말하는 부분: 한 답글은 이렇게 적었습니다. 구독은 보조되는 느낌인데, OpenAI와 Anthropic의 API 가격은 “터무니없이 비싸다.” 같은 창의 다른 글은, 멀티 에이전트 프롬프트 하나가 API 요금으로 얼마인지 사람들이 알기나 하는지 물었고, ChatGPT / Codex 구독 계량과 API 계량은 서로 이야기하지 않는다고 상기시켰습니다.

PoYo의 답: 문서화된 세 가지가 이 불만에 맞습니다.

  1. 선불 크레딧이며, 구독 계량은 없다. 홈페이지는 크레딧 가격, 일회 구매, 반복 구독 없음, 만료되지 않는 크레딧을 설명합니다. 성공한 생성에 대해 지불합니다. 실패한 작업은 청구되지 않습니다(llms.txt).
  2. 키 하나, 잔액 하나. 채팅과 미디어는 PoYo 계정 하나를 공유합니다. GET /api/user/balance를 폴링해 credits_amount를 읽으십시오(사용자 잔액).
  3. 공개된 모델별 가격. 현재 가격은 각 모델 페이지 / https://poyo.ai/models/<id>/llms.txt와 카탈로그 색인(llms.txt)에 있습니다. 유료 작업을 제출하기 전에 그곳을 확인하고, 기억으로 달러 금액을 짐작하지 마십시오. 작업 기록(시작하기에 설명됨)에서 나중에 모델, 입력, 상태를 볼 수 있습니다.

Q7. “서버 함수” / Telegram 봇은 누구나 호출할 수 있다. 키는 curl이 찾을 수 있는 곳에 있다.

개발자가 불만을 말하는 부분: 실무적인 보안 글이 계속 올라옵니다. API 키를 제한하고 일일 할당량을 두십시오. 공급자 키를 채팅 UI나 Telegram 에이전트에 붙여 넣지 마십시오. 사용자별 속도 제한과 지출 천장이 없는, 호출 가능한 서버 함수 안의 키는 URL을 찾은 사람에게 신용카드입니다.

PoYo의 답: 시작하기는 분명합니다. 프런트엔드 코드(브라우저, 모바일 앱, 공개 저장소)에 API 키를 노출하지 마십시오. 키를 비밀로 다루고 서버에 두며, 프로덕션 키에 대해 이미 문서화된 제어를 쓰십시오.

  • API 키 페이지에서 IP 허용 목록과 키별 시간 / 일 / 누적 한도를 두십시오.
  • X-End-User-ID를 요구한 뒤, 키 전체를 교체하지 않고 남용 호출자를 HTTP 403 end_user_blocked로 막으십시오(엔드유저 식별).
  • 프로덕션에 들어가기 전에 401, 402, 429를 명시적으로 처리하십시오(시작하기, 오류 코드).

한눈에 보기

불만PoYo 문서의 위치
빠른 출시에서의 Terra / Codex 429오류 코드 · 시작하기: 속도 제한 · llms.txt
429로 위장한 지출 한도오류 코드: 402와 429 · 홈페이지: 크레딧 · 잔액 API
Agent SDK / 한도 하나를 태우는 병렬 에이전트시작하기: 비동기와 429 · API 개요 · API 키 한도
유출된 키와 무단 지출API 키 페이지 · 시작하기 · X-End-User-ID
무조건 재시도 / 영상 작업이 두 번오류 코드 · 시작하기: 재시도는 새 유료 작업일 수 있음 · llms.txt: 실패는 미청구
구독 대비 비싼 API / 불투명한 잔액홈페이지: 크레딧 · 잔액 API · llms.txt 가격
봇 / 채팅 UI / 서버 함수에 남은 키시작하기: 키를 노출하지 말 것 · API 키 페이지 · X-End-User-ID
Share: