변경 기록

PopNow를 기준으로 작성한 코드에 영향을 주는 변경 사항을 최신순으로 적었습니다. 조치가 필요 없는 추가 기능도 함께 적어, 무엇이 가능해졌는지 볼 수 있게 했습니다. 날짜는 UTC 기준입니다.

조치 필요라고 적혀 있지 않은 한, 아래의 어떤 변경도 기존 연동을 깨뜨리지 않습니다.

2026-10-23

조치 필요: 별도의 API USD 잔액. API 키 호출, API 키 MCP, Playground는 초기 잔액 $0인 별도의 API USD 잔액을 씁니다. 웹사이트 크레딧과 API 자금은 서로 이체하거나 대신 쓸 수 없습니다. OAuth MCP는 계속 웹사이트 크레딧을 씁니다. 모델 요율은 같습니다. 키는 API keys에서 만들고 입금과 API 결제 내역은 API billing에서 확인하세요. 표시와 회계에는 기존 USD 필드(costUsd, estimatedCostUsd, maxChargeUsd, availableUsd, heldUsd, totalUsd, totalSpend)를 쓰세요. 견적 확정은 기존 USD 필드로 하며 견적이 만료되기 전에 같은 요청으로 quoteId와 expectedCostUsd: quote.maxChargeUsd를 보냅니다. API 결제와 API 잔액과 환불을 보세요. 아래의 이전 항목은 각 날짜 당시의 동작을 설명하며, 예전의 공통 크레딧 방식과 정수 크레딧 올림도 당시 정보입니다.

조치 필요: 저장한 레시피의 USD 승인. API 키를 사용하는 REST와 MCP 레시피·워크플로 실행은 이제 USD 견적을 사용합니다. 먼저 견적을 요청한 뒤 같은 입력에 currency: "USD", 십진수 문자열인 max_usd, quote_id를 넣어 승인하세요. 기존 크레딧 한도는 거부합니다. 실행을 읽거나 재개할 때는 원래 키를 사용하세요. 새 재개 엔드포인트와 resume_recipe_run 도구는 이미 지출한 금액과 진행 중인 작업에 확보한 금액을 포함하는 전체 실행의 예산을 견적하고 승인합니다. unpriced_steps가 있는 견적은 현재 가격이 계산된 단계만 포함하며, 이후 단계는 새 견적과 승인을 기다립니다. OAuth MCP 레시피 실행은 계속 웹사이트 크레딧을 사용합니다. 저장한 레시피를 참고하세요.

문서에 추가된 채팅 모델. Claude, Gemini, DeepSeek, GLM, Grok, Kimi를 같은 API 키로 호출할 수 있습니다. OpenAI Chat Completions와 Responses(https://api.popnow.ai/v1), Anthropic Messages, Gemini generateContent를 지원하며, 토큰 단위로 USD이 청구됩니다. 채팅 모델에 기본 URL, SDK 예제, 스트리밍, 토큰당 가격, 요청이 청구되는 방식이 정리되어 있고, API 레퍼런스에는 경로가 나와 있습니다. 여기에는 그동안 빠져 있던 레시피, 스킬, 에이전트 스킬 엔드포인트도 함께 실렸습니다.

문서에서 길 찾기가 쉬워졌습니다. 문서 홈에도 다른 페이지와 같은 사이드바가 생겼고, 사이드바는 하는 일에 따라 다시 묶였으며, 모든 페이지를 12개 언어로 볼 수 있습니다.

2026-10-22

패키지 레지스트리에 올라간 SDK와 연동. 공식 오픈소스 패키지는 이제 GitHub에서 설치할 필요가 없습니다.

• Python: pip install popnow(PyPI). JavaScript와 TypeScript: npm install popnow(npm, JSR에도 있음). CLI: npm install -g @popnow/cli.
• PHP: composer require popnow/popnow(Packagist). Go: go get github.com/popnow-ai/popnow-go. 새로 추가된 Java 클라이언트는 Maven Central의 ai.popnow:popnow-java입니다.
• ComfyUI: 노드 팩은 Comfy Registry의 popnow-comfyui입니다. ComfyUI Manager에서 설치하거나 comfy node install popnow-comfyui로 설치하세요. 단일 파일 노드도 여전히 작동합니다. 둘 중 하나만 쓰세요.
• n8n: 커뮤니티 노드 n8n-nodes-popnow가 npm에 있습니다. 직접 설치한 n8n에서는 Settings > Community Nodes에서 설치하세요. 아직 인증된 노드가 아니므로 n8n Cloud에서는 계속 HTTP Request 워크플로를 쓰세요.
• 새로 추가된 것: popnow-proxy(npm install @popnow/proxy)를 쓰면 브라우저나 모바일 앱이 API를 호출할 때 API 키를 서버에 둘 수 있습니다. popnow-bot은 직접 운영하는 Telegram·Discord 봇입니다. MCP stdio 브리지는 npx -y @popnow/mcp로 실행합니다.

전에 GitHub에서 설치했다면 레지스트리 패키지로 바꿀 수 있습니다. import 구문은 그대로입니다. 모든 명령은 SDK, CLI, 오픈소스 도구에 있습니다.

2026-10-21

저장한 레시피, 워크플로, 스킬을 실행하세요. Studio에 저장한 레시피, 캔버스에서 저장한 워크플로, Poppie 스킬을 이제 API에서 목록으로 보고 실행할 수 있습니다. GET /api/v1/recipes, POST /api/v1/recipes/{id}/run(가격 상한을 두려면 maxCredits 사용), GET /api/v1/recipes/runs/{runId}, 그리고 GET /api/v1/skills입니다. MCP에는 짝이 되는 도구 다섯 개가 추가되었습니다. list_my_recipes, run_my_recipe, get_recipe_run, list_my_skills, use_my_skill입니다. 모두 나와 내 팀에게만 공개됩니다. 내 레시피, 워크플로, 스킬을 참고하세요. 개발자 콘솔에는 각 항목의 ID와 바로 실행할 수 있는 코드를 보여 주는 Recipes & skills 페이지가 새로 생겼습니다.

2026-10-19

조치 필요: 1크레딧이 이제 $0.001이며, 가격이 내려갔습니다. 전에는 1크레딧이 $0.01이었지만, 이제는 $0.001입니다. 모든 잔액, 가격, 크레딧 금액이 전과 같은 미국 달러 가치를 유지한 채 숫자만 10배가 되었습니다. 동시에 모든 모델의 가격이 약 3분의 1 정도 내려서, 같은 요청이 이제 전보다 적은 달러가 듭니다.

• 잔액이 환산되었습니다. 잃은 것은 없습니다. 예를 들어 500크레딧($5)이던 잔액은 이제 5,000크레딧($5)입니다. 키에 설정한 지출 한도는 같은 달러 금액을 유지하며, 새 크레딧 숫자로 표시됩니다.
• API 필드. credits, maxCredits, expectedCredits, estimatedCredits, availableCredits, heldCredits, totalCredits와 GET /api/v1/models의 credits 가격은 모두 새 단위입니다. 미국 달러 문자열(cost, maxCharge, estimatedCost, available …)은 예전과 같은 의미입니다. 코드에서 크레딧을 100으로 나눠 달러로 바꿨다면 이제 1,000으로 나누세요. 크레딧 기준값이나 예산을 저장한다면 10을 곱하세요.
• 이전 견적. 변경 전의 quoteId와 expectedCredits는 더 이상 맞지 않습니다. createTask는 40901(가격 변경됨)을 돌려주고 아무것도 잡아 두지 않습니다. 다시 견적을 받고 새 가격을 보여 주세요.
• 올림. 작업은 여전히 정수 크레딧으로 올림하여 청구되지만, 이제 1크레딧이 10분의 1센트이므로 올림 단위가 10배 작아졌습니다.
• MCP. 300크레딧 이하의 작업은 바로 시작됩니다. 그보다 큰 작업은 여전히 사용자의 승인을 기다립니다. ChatGPT와 Claude에서 PopNow 쓰기를 참고하세요.
• 크레딧 팩. 팩은 $9에 9,000크레딧부터 시작하며, 큰 팩에는 보너스 크레딧이 붙습니다. 또한 $10~$2,000 사이에서 $1당 1,000크레딧의 금액을 직접 정해 살 수 있습니다. 가격 페이지와 크레딧과 환불을 참고하세요.

오픈소스 SDK와 도구. PopNow의 개발자용 코드가 github.com/popnow-ai에서 MIT 라이선스로 공개되었습니다. Python과 JavaScript 및 TypeScript SDK, CLI, Go와 PHP 클라이언트, MCP 설정 가이드, Agent Skills, 예제가 포함된 OpenAPI 파일, 그리고 Blender 애드온, ComfyUI 노드 팩, n8n 커뮤니티 노드의 소스입니다.

• 이 중 어떤 것도 아직 npm, PyPI, Packagist, ComfyUI Registry에는 없습니다. 새 SDK, CLI, 오픈소스 도구 페이지에 나온 대로 GitHub에서 설치하세요.
• 빠른 시작은 기존의 일반 HTTP 예제는 그대로 두고, 그 옆에 Python과 JavaScript SDK 예제를 함께 보여 줍니다.

2026-10-17

원격 MCP 서버. PopNow가 이제 https://api.popnow.ai/mcp에서 MCP 서버를 운영합니다. 사용자는 ChatGPT나 Claude에 추가해 채팅에서 이미지, 영상, 노래, 내레이션을 만들 수 있고, 개발자는 Cursor, VS Code, Claude Code 또는 자체 MCP 클라이언트에 추가할 수 있습니다. 도구는 열두 개이며, OAuth 2.1 로그인 또는 sk-popnow- API 키를 쓰고, 다른 곳과 같은 크레딧과 가격을 씁니다. 30크레딧 이하의 작업은 바로 시작됩니다(2026-10-19부터는 300크레딧). 그보다 큰 작업은 사용자의 확인을 기다립니다. ChatGPT와 Claude에서 PopNow 쓰기를 참고하세요.

• 연결은 Account settings → Devices → Connected AI apps에서 확인하고 삭제할 수 있습니다.
• API 키로 한 호출은 그 키의 지출 한도에 포함되며, 콘솔 로그에 나타납니다.
• 영상 이펙트(Zombie Turn, Flying Car 등 Effects 페이지의 전부)는 apply_effect를 통해 채팅 앱에서 쓸 수 있습니다. 이는 REST 엔드포인트가 아닙니다.

새 문서. 크레딧과 환불, n8n, ComfyUI, Blender 애드온의 연동 가이드, 레시피, 그리고 이 변경 기록입니다. 웹훅에는 콘솔에서 계정 엔드포인트를 관리하는 방법을 다룬 섹션이 추가되었습니다.

크레딧 팩 환불 규칙. 크레딧 팩은 구매한 지 7일 이내(EU와 영국의 소비자는 14일)에, 그 팩의 크레딧을 하나도 쓰지 않았다면 환불할 수 있습니다. 실패한 생성은 계속해서 자동으로 환불됩니다. 무료 보상 크레딧은 팩의 크레딧보다 먼저 쓰이며, 팩은 오래된 것부터 최신 순으로 쓰입니다. 자세한 내용은 크레딧과 환불을 참고하세요.

popnow.ai의 연동 페이지. n8n, ComfyUI, 레시피 페이지가 생성되는 코드 옆에 실제 결과물을 함께 보여 주도록 바뀌었습니다.

2026-10-16

PopNow API 공개. 이미지, 영상, 오디오 생성을 위한 REST API가 https://api.popnow.ai/api/v1에서 열렸습니다. 이 문서는 popnow.ai/docs에서 12개 언어로 제공되며, 도구와 에이전트를 위해 OpenAPI 파일과 llms.txt도 함께 제공합니다.

• 키는 sk-popnow-로 시작합니다. 접두사가 바뀌기 전에 만든 키도 계속 작동하므로 교체할 필요가 없습니다.
• 금액은 크레딧 단위입니다(출시 때는 1크레딧 = $0.01, 2026-10-19부터는 $0.001). credits, maxCredits, expectedCredits, availableCredits와 기타 크레딧 필드는 미국 달러 문자열 옆에 있습니다. 크레딧 필드를 쓰세요.
• 모델 ID는 <maker>/<model>/<task> 형식입니다. 예: google/nano-banana-2.1/text-to-image. PopNow 자체 도구는 제작사로 popnow를 씁니다.
• 업로드(popnow://f/…)와 에셋 라이브러리 항목(popnow://a/…)의 popnow:// 참조는 모든 미디어 필드에서 쓸 수 있습니다. 미디어를 참고하세요.
• 채팅 및 텍스트 모델은 공개 API에 포함되지 않습니다. API는 이미지, 영상, 오디오 생성을 다룹니다.

웹훅 페이로드 버전 2. 새 작업 콜백은 X-Webhook-Payload-Version: 2와 함께 전송되며, 본문은 recordInfo와 같습니다. 웹훅을 참고하세요.

개발자 콘솔. 계정 단위 웹훅 엔드포인트(Standard Webhooks 서명, 계정당 최대 16개, 엔드포인트마다 시크릿 하나), 수동 재전송이 가능한 전송 로그, 모든 모델의 API 페이지에서 쓸 수 있는 Playground 실행, 로그의 키 필터, 사용량 CSV 내보내기가 추가되었습니다.

제출 시 콘텐츠 검사. 프롬프트와 입력 이미지는 작업이 접수되기 전에 검사됩니다. 거절된 요청은 data.reason과 함께 400을 돌려주며, 아무것도 잡아 두지 않고 비용도 들지 않습니다. 모델 자체가 거절한 요청은 여전히 content_rejected로 실패하며, 이때도 비용은 없습니다.

중국어 오류 메시지. msg와 errorMessage가 이제 zh-CN과 zh-TW에서도 Accept-Language를 따릅니다. 이미 지원하던 열 개 언어에 더해진 것입니다. 코드는 바뀌지 않았습니다. 오류를 참고하세요.

/v1 아래의 OpenAI 호환 영상 경로는 키를 x-api-key 헤더로도 받습니다. OpenAI Videos를 참고하세요.

Blender 애드온 0.1.0. Blender 4.2 이상에서 API 키로 클레이 장면을 렌더링하고, 애니메이트하고, 텍스처를 입힐 수 있습니다. Blender 애드온을 참고하세요.

2026-10-15

에셋 라이브러리: 캐릭터. 캐릭터(웹사이트에서 배치한 참조 이미지 묶음에 이름을 붙인 것)가 에셋 라이브러리에 저장되며, GET /api/v1/assets/entities로 읽을 수 있습니다. 각 이미지는 생성 요청에 쓸 수 있도록 고유한 popnow://a/… URI를 가집니다. 캐릭터는 웹사이트에서 만들고 편집하며, API는 읽기만 합니다. 에셋을 참고하세요.

관련 문서