guides

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

PoYo Team
7 min read
Share:

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


Q1. Claude Code가 리팩터 도중에 사용 한도 벽에 부딪혔다. “내 API 키로 되돌리는” 깨끗한 경로는 아직 없다.

개발자가 불만을 말하는 부분: 10월 27–28일 타임라인에는 Claude Code와 Codex의 사용 한도 화면을 나란히 둔 캡처가 가득했습니다. 개발자는 구독 한도에 닿은 뒤 Claude Code가 API 키로 돌아갈 수 있는지 물었고(@irl_danB), 리팩터 도중에 한도에 닿는 일이 새로운 “저장을 잊음”이라고 농담했으며(@automater_ai), 한 스택에서는 20달러 계층이 쓸모없어 보이는데 다른 Plus 구독은 한 번도 한도에 걸리지 않는다고 비교했습니다(@mozdca, @LeoZhang57).

PoYo의 답: PoYo는 선불 크레딧이며, 구독의 5시간 또는 주간 창이 아닙니다. 홈페이지는 일회성 크레딧 구매, 반복 구독이 없음, 크레딧이 만료되지 않음을 적습니다. 성공한 생성에 대해 지불합니다. llms.txt는 실패한 작업은 청구되지 않는다고 합니다. 채팅과 미디어는 API 키 하나와 잔액 하나를 공유합니다. 실시간 credits_amount가 필요하면 GET /api/user/balance를 폴링하십시오(사용자 잔액).

잔액이 없으면 PoYo는 굴러가는 사용 창을 스로틀처럼 꾸민 것이 아니라 402 insufficient_credits_error를 반환합니다(오류 코드). 청구가 이미 크레딧 기반이므로, “구독 → API 키” 장애 조치라는 제품 기능은 문서에 없습니다. 폭주하는 에이전트에는 API 키 페이지의 키별 시간 / 일 / 누적 사용 한도를 두십시오(시작하기).


Q2. Claude Code의 “429”는 서로 다른 메시지 세 개다. 끝없이 기다리는 일은 그중 하나에만 도움이 된다.

개발자가 불만을 말하는 부분: 문제 해결 글은 Claude Code가 429처럼 보이는 실패를 세 가지로 낸다고 짚었습니다. 재설정을 기다리기, 잠시 뒤 다시 시도하기, API 키를 확인하기. 각각 다른 수정이 필요합니다(@aiparabellum). 별도로 개발자는 Anthropic 에이전트 도구의 속도 제한 문제가 고쳐졌는지 물었습니다(@XavierDelon, @GeorgeMathew_).

PoYo의 답: 오류 코드는 청구와 속도 제한을 다른 번호에 둡니다.

코드error.type의미 / 할 일
401authentication_error키가 없거나 유효하지 않습니다. 자격 증명을 고치십시오. 같은 잘못된 키로 재시도하지 마십시오(시작하기).
402insufficient_credits_error잔액이 없습니다. 충전하십시오. 재시도는 도움이 되지 않습니다.
429rate_limit_error속도 제한입니다. 기다리거나 대기열에 넣으십시오.
500 / 502 / 503internal_error / upstream_error / service_error지수 백오프.

기본 생성 처리량은 계정당 10초에 새 요청 20건까지로 문서에 있습니다. 초과분은 HTTP 429를 받고 대기열에 들어가지 않습니다(시작하기). 통합 문제 해결도 말합니다. 속도 제한에서는 Retry-After를 지키십시오. task_id가 만들어졌는지 알기 전에는 유료 제출을 무조건 재시도하지 마십시오(문제 해결).

문서는 업스트림 공급자 사이의 자동 장애 조치가 없다고 적습니다. 그것은 클라이언트에 넣으십시오.


Q3. 에이전트 채팅에 한 번이라도 붙여 넣은 API 키는 아직 프로젝트 로그에 있다.

개발자가 불만을 말하는 부분: Claude 프로젝트 로그에 대한 글 뒤, 한 답글이 위험을 바로 짚었습니다. 채팅에 한 번이라도 붙여 넣은 API 키는 그 로그에도 있습니다. ~/.claude/projects에서 sk-를 grep하고, 나오는 것은 교체하십시오(@wazX_7). 근처 글은 같은 위생을 반복했습니다. AI 키를 root 자격 증명처럼 다루십시오(@RuntimeAI_io). 중지 스위치 없는 공유 키 하나를 모든 에이전트에 주지 마십시오(@RohanBhanotAI).

PoYo의 답: 시작하기는 분명합니다. 프런트엔드 코드, 모바일 앱, 공개 저장소에 API 키를 노출하지 말고, 비밀로 다루십시오. 키는 서버에 두십시오. 붙여 넣기 또는 유출이 의심된 뒤:

  1. API 키 페이지에서 키를 폐기 / 교체하십시오.
  2. IP 허용 목록을 두어, 복사된 키는 승인된 서버 IP에서만 동작하게 하십시오.
  3. 키별 시간 / 일 / 누적 한도를 두어, 유출에 천장을 두십시오.
  4. 생성과 네이티브 채팅에 **X-End-User-ID**를 보내십시오. 키 전체를 교체하지 않고, 남용 호출자 하나를 HTTP 403 end_user_blocked로 막으십시오(엔드유저 식별).

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


Q4. 잊어버린 집계 키는 여전히 에이전트의 지갑이다. 호스트 침해가 유휴 자격 증명을 500단계 작업으로 바꿨다.

개발자가 불만을 말하는 부분: 한 글은 잊어버린 OpenRouter 키가 여전히 에이전트의 지갑이라고 경고했습니다. Railway 형태의 침해가 유휴 키를 폐기 목록에 올렸고, 그중 하나는 그때까지 대시보드 트래픽이 0이었는데도 이미 500단계 에이전트 작업의 비용이 되어 있었습니다. 짚은 조치는 지출 한도, 짧은 수명의 키, 그리고 더 이상 보지 않는 호스트에 공급자 토큰을 두지 않는 것입니다(@neiro_go_neiro). 다른 답글은 같은 형태를, 침해 몇 주 뒤에도 키를 폐기하고 있는 공급자에 연결했습니다(@Kenz_1604).

PoYo의 답: 버려진 호스트의 유휴 키는 클라이언트 쪽 비밀의 문제입니다. 비밀이 생긴 뒤, PoYo가 문서화한 제어는 영향 범위를 제한합니다.

  • 환경 / harness마다 키를 따로 만들고, 각각에 시간, 일, 누적 사용 한도를 두십시오(API 키 페이지, 시작하기).
  • 프로덕션 키에는 IP 허용 목록을 켜십시오.
  • **X-End-User-ID**를 우선하여, 키를 지우지 않고 호출자 하나를 막을 수 있게 하십시오(엔드유저 식별).
  • GET /api/user/balance로 실시간 잔액을 보고(사용자 잔액), 작업 기록은 대시보드에서 보십시오(시작하기).

더 쓰지 않는 키는 삭제하십시오. 문서는 미사용 키의 자동 만료도, 침해로 생긴 지출의 환불 SLA도 적지 않습니다. 그렇게 말하고, 교체하십시오.


Q5. AI 지출에 단단한 한도를 두었다. 그다음 누군가 키를 얻어 하룻밤 사이에 그 한도를 넘겼다.

개발자가 불만을 말하는 부분: 한 개발자는 AI 청구 한도를 25달러로 두었습니다. 누군가 API 키를 얻어 하룻밤에 55달러까지 썼습니다(@twentyonemilll). 주제는 이전 OpenRouter 글과 같습니다. 비활성화로는 부족했고, 키를 완전히 삭제해야 유출이 멈췄습니다. 10월 28일 창은 여전히 같은 불만을 냅니다. 한도는 있었다. 유출은 그래도 아팠다.

PoYo의 답: 한도는 침해된 자격 증명 위에서 강제될 때만 도움이 됩니다. 대시보드의 부드러운 예산만으로는 부족합니다. PoYo에서는:

  • 모든 프로덕션 키에 키별 시간 / 일 / 누적 사용 한도를 두십시오(시작하기, API 키 페이지).
  • IP 허용 목록과 함께 두어, 공격자의 네트워크에서는 키가 실패하게 하십시오.
  • 멀티테넌트 앱에는 **X-End-User-ID**와 차단을 쓰십시오(엔드유저 식별).
  • 402에서는 멈추십시오. 크레딧이 없다는 뜻입니다(오류 코드). 큰 배치 전에 잔액을 폴링하십시오(사용자 잔액).

키가 밖에 나갔을 수 있다면 삭제 / 폐기하십시오. 부드러운 알림만 낮추지 마십시오. 공개 문서는 유출된 키의 지출에 대한 환불을 주장하지 않습니다.


Q6. Google API 키를 받는 일이 너무 고통스러워 “그냥 집계기를 쓴다”가 기본이 되었다.

개발자가 불만을 말하는 부분: 한 개발자는 API 키 가입 절차가 고쳐져야 Google 모델을 시도하겠다고 했습니다. 그때까지는 OpenRouter만 쓴다고 했습니다(@sandipb). 근처 글은 집계기를 에이전트의 결제 지갑이자 모델 전환으로 계속 두었고(@tomcritchlow), 다른 사람은 시험만 하려고 공급자 키를 열몇 개 들고 있습니다(@sunwei57247249).

PoYo의 답: PoYo는 이미지, 영상, 음악, 3D, 채팅을 하나의 통합 키로 다루도록 만들어졌습니다(llms.txt, 홈페이지). 키는 API 키 페이지에서 만듭니다. 미디어는 비동기 POST /api/generate/submit에 상태 또는 webhook을 더합니다. 채팅은 모델별 문서에 있는 대로 OpenAI 호환, Claude Messages, 또는 Gemini 네이티브 엔드포인트를 씁니다. 모델을 바꾸는 일은 model 문자열을 바꾸는 일입니다(채팅에서는 맞는 엔드포인트 형태도 맞춥니다). 새 공급자 온보딩이 아닙니다.

현재 입력 스키마와 가격은 https://poyo.ai/models/<id>/llms.txt 와 카탈로그 색인에 있습니다(llms.txt). 문서는 PoYo가 각 연구소 공식 계정의 통과 경로라고 주장하지 않습니다. 전체 안정성이 공식 공급자보다 약간 낮을 수 있다고도 합니다(시작하기). 그 트레이드오프는 의식해서 고르십시오.


Q7. 클립을 몇 개만 낸다면 59달러 영상 구독은 비싼 입장 방식이다. 재시도는 두 번째 청구를 만들 수 있다.

개발자가 불만을 말하는 부분: 제작자는 월간 영상 도구 요금제와 클립 단위 API를 비교했습니다. 한 달에 AI 영상을 몇 개만 만든다면 59달러 요금제가 더 비싼 경로일 수 있습니다. API는 클립마다 청구하고, 코딩 에이전트가 그것을 돌릴 수 있습니다(@aliteqai). 관련된 API 고통은, 완성된 영상 다운로드가 청구 정산을 기다려야 열리는 것(@MariaOnchainDev)과, 무조건 재시도가 청구되는 두 번째 작업을 만든다는 계속되는 걱정입니다.

PoYo의 답: PoYo의 영상은 성공한 출력마다 크레딧으로 가격이 매겨지며, 모델마다 다릅니다. 영상 카탈로그는 llms.txt에 있습니다(Sora 2, Veo 3.1, Kling, Wan, Seedance, Hailuo 등). 절차는 통합 비동기 API입니다. 제출한 뒤 상태를 폴링하거나 callback_url을 설정합니다(시작하기, 웹훅). 홈페이지와 llms.txt는 모두 실패한 작업은 청구되지 않는다고 합니다.

느린 영상 작업에서 재시도를 연타하기 전에, 시작하기는 제출 재시도마다 새로운 유료 작업일 수 있다고 경고합니다. 원래 요청이 이미 task_id를 만들었는지 확인하십시오. 공격적인 폴링보다 웹훅을 우선하십시오. 402, 429, 5xx는 오류 코드 표를 따르십시오. 크레딧 중단을 속도 제한처럼 다루지 마십시오.


한눈에 보기

불만PoYo 문서의 위치
사용 한도 벽 / 구독에서 API로 넘기는 장애 조치가 없음홈페이지: 크레딧 · 잔액 API · 오류 코드: 402 · API 키 한도
429가 서로 다른 실패 세 가지를 뜻함오류 코드: 401 / 402 / 429 / 5xx · 시작하기: 속도 제한 · 문제 해결
에이전트 로그에 붙여 넣은 키시작하기: 키를 노출하지 말 것 · API 키 페이지 · X-End-User-ID
호스트 침해 뒤의 유휴 집계 키API 키 한도 · IP 허용 목록 · 잔액과 작업 기록 · 쓰지 않는 키 폐기
유출된 키가 뚫은 지출 한도키별 한도 · IP 허용 목록 · X-End-User-ID · 402 처리
고통스러운 공급자 키 온보딩 / 키 난립PoYo 키 하나 · llms.txt 카탈로그 · 모델별 llms.txt
영상 구독 대 클립 단위와 재시도 청구영상 카탈로그 · 비동기 제출/상태 · 실패는 미청구 · 재시도는 새 유료 작업
Share: