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

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

---

Q1. 또 다른 SaaS가 침해당했고, AI API 키도 함께 나갔습니다.

개발자가 불만을 말하는 부분: 잘 알려진 SaaS 침해로 AI API 키가 대량 유출되어 사기 트래픽에 쓰였다는 보고가 있습니다. 별도로 Railway와 연결된 OpenAI API 키 유출 보고가 있었고, 한 개발자는 자기 키도 아닌 유출 키에 대한 OpenAI 메일을 받았다고 했습니다. 프런트엔드 실수는 일을 더 키웁니다. 브라우저에 노출된 API 키는 여전히 흔한 결함입니다.

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

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

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

---

Q2. 모델 공급자가 내가 경쟁하는 앱을 내면, 먼저 풀리는 것은 속도 제한입니다.

개발자가 불만을 말하는 부분: 한 개발자는 이렇게 적었습니다. API 공급자가 내가 경쟁하는 제품도 내면, 먼저 풀리는 것은 속도 제한이다. Reddit 스레드는 같은 운영 질문을 반복합니다. 프로덕션에서 Claude API 속도 제한을 어떻게 다루는지, 그리고 AI 공급자 속도 제한에 어떤 접근이 통하는지입니다.

PoYo의 답: 오류 코드 페이지는 각 상태에 하나의 의미와 하나의 권장 동작을 줍니다.

시작하기는 기본 생성 한도를 공개합니다. 계정당 10초마다 새 생성 요청은 최대 20건입니다. 그 한도를 넘는 요청은 HTTP 429를 받고 대기열에 들어가지 않습니다. 채팅과 미디어 모델은 PoYo 키 하나를 공유하고 llms.txt에 있습니다. 모델 전환은 model 문자열을 바꾸는 일이며, 새 공급자 온보딩이 아닙니다. 429가 계속되면 문서는 더 높은 한도를 위해 지원에 연락할 수 있다고 합니다. 승인은 신중하게 처리됩니다.

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

---

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

개발자가 불만을 말하는 부분: OpenAI의 단단한 지출 한도는 project_spend_limit_exceeded / organization_spend_limit_exceeded와 함께 429로 나타날 수 있습니다. 팀은 청구 중단을 스로틀처럼 다룹니다. 영상 API에서 한 개발자는 402는 요금을 예약할 할당량이 부족하다는 뜻이고, 409는 멱등 사례라고 적었습니다. 다른 알림은 실무적입니다. 지출 한도를 두십시오. 루프이든, curl을 든 낯선 사람이든 청구는 같습니다.

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

청구 자체는 선불 크레딧입니다. 홈페이지는 일회 구매이고 반복 구독은 없으며, 크레딧은 만료되지 않는다고 적습니다. 실시간 숫자가 필요하면 GET /api/user/balance를 폴링해 credits_amount를 읽으십시오(사용자 잔액).

---

Q4. OpenAI, Anthropic, OpenRouter 가운데 어느 모델이 예산을 먹었는지 보이지 않습니다.

개발자가 불만을 말하는 부분: 한 개발자는 OpenRouter 지출 급증을 모델별로 나눌 수 있는지 물었습니다. 다른 사람들은 OpenAI / Anthropic / xAI용 View Spend 같은 도구를 가리켰습니다. 기업 이야기도 Replit이 할인을 위해 1억 달러가 넘는 AI 지출을 Anthropic에서 OpenAI로 옮겼다는 점을 상기시킵니다. 공급자는 다르고 청구서도 다릅니다. 보이지 않는 지점은 같습니다.

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

1. 키 하나, 잔액 하나. 채팅과 미디어는 PoYo 계정 하나를 공유합니다. GET /api/user/balance를 폴링해 credits_amount를 읽으십시오(사용자 잔액).
2. 키별 시간, 일, 누적 한도는 API 키 페이지에 있습니다. 에이전트 하나나 환경 하나가 계정 전체를 비울 수 없습니다(시작하기).
3. 작업 기록과 공개 가격. 시작하기가 설명하는 작업 기록에서 모델, 입력, 상태를 확인하십시오. 채팅과 미디어 가격은 요금 페이지에서 비교하고, 모델별 현재 가격은 llms.txt 또는 각 모델의 llms.txt에서 읽으십시오.

---

Q5. “서버 함수”는 누구나 호출할 수 있고, 키는 curl이 찾는 곳에 있습니다.

개발자가 불만을 말하는 부분: 같은 지출 한도 글은 누구나 호출할 수 있는 서버 함수에는 사용자별 속도 제한과 지출 한도가 필요하다고도 경고했습니다. 다른 글은 단호합니다. 브라우저 채팅 템플릿에 OpenAI 키를 넣지 마십시오. 오래된 조언도 아직 맞습니다. GitHub에 .env를 올리지 마십시오.

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

• IP 허용 목록과 키별 시간 / 일 / 누적 한도는 API 키 페이지에 있습니다.
• X-End-User-ID를 요구한 뒤, 키 전체를 교체하지 않고 남용 호출자를 HTTP 403 end_user_blocked로 막으십시오(엔드유저 식별).

---

Q6. 영상 API는 초 단위로 크레딧을 태웁니다. 사용량 화면은 여전히 토큰처럼 보입니다.

개발자가 불만을 말하는 부분: 토큰 미터에 익숙한 사람에게 영상 과금은 계속 헷갈립니다. 오래됐지만 아직 인용되는 스레드에는 영상 과금 방식과 맞지 않는 API 사용량 화면과 재과금이 헷갈리는 Sora API 확장 업데이트가 있습니다. 주제는 현재형입니다. 요금을 예약할 할당량이 부족하면 영상은 402를 반환합니다.

PoYo의 답: Sora 2 Official과 관련 영상 모델은 llms.txt와 AI 영상 API 페이지를 통해 PoYo 카탈로그에 있습니다. 공개 페이지가 실제로 적는 과금 규칙은 다음과 같습니다.

• 성공한 출력당 크레딧. 가격은 모델별입니다(llms.txt).
• 실패한 작업은 청구되지 않습니다(홈페이지와 llms.txt).
• 현재 가격은 각 모델 페이지와 https://poyo.ai/ko/models/<model-id>/llms.txt에 있습니다. 유료 작업을 제출하기 전에 확인하고, 금액을 기억으로 추론하지 마십시오.
• 생성은 비동기입니다. POST /api/generate/submit 다음, 상태를 폴링하거나 callback_url을 설정합니다(시작하기). 크레딧이 부족하면 **402 insufficient_credits_error**가 옵니다(오류 코드).

---

Q7. 봇을 만드는 사람은 모두 배웁니다. 진짜 제품 관리자는 API이고, 속도 제한이 로드맵을 씁니다.

개발자가 불만을 말하는 부분: 한 글은 이렇게 요약했습니다. 봇을 만드는 사람은 모두 API가 진짜 제품 관리자라는 것을 배운다. 속도 제한이 로드맵을 쓰고 있다. 에이전트 스타트업은 데모 도중에 API가 속도 제한하지 않기를 바란다고 적습니다. 다른 사람들은 429 / 5xx에서의 장애 조치를 공개적으로 찾습니다.

PoYo의 답: PoYo의 생성은 비동기로 설계되어, 긴 작업이 단일 게이트웨이 시간 초과에 묶이지 않습니다. 시작하기와 API 개요는 작업을 제출하고 task_id를 저장한 뒤, 상태를 폴링하거나 webhook을 받으라고 합니다. 프로덕션 부하에서 문서는 잦은 폴링보다 서명된 webhook을 선호합니다. 429에서는 기다리거나 대기열에 넣으십시오(오류 코드). 기본 생성 한도는 여전히 계정당 10초에 새 요청 20건이며, 초과분은 거부되고 대기열에 들어가지 않습니다. 이미지, 영상, 음악, 채팅, 3D는 통합 API 키 하나 뒤에 있습니다(llms.txt, 홈페이지). 더 높은 한도가 필요하면 지원에 연락하십시오. 승인은 신중하게 처리됩니다.

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

---

한눈에 보기