호환 API와 AI 에이전트
본문AI 에이전트와 MCP
지금 Claude, ChatGPT, Cursor 같은 에이전트에서 PopNow API를 쓰는 방법과, MCP 서버가 열리면 더해지는 것.
AI 어시스턴트와 코딩 에이전트는 지금 바로 PopNow로 이미지, 영상, 오디오를 만들 수 있습니다. API 키를 건네고 기계가 읽는 문서를 가리키면 됩니다. Claude, ChatGPT, Cursor 같은 클라이언트에 주소 하나만 추가하면 되는 MCP 서버는 준비 중이며 아직 열리지 않았습니다. MCP 페이지에 예정된 도구가 있고, 출시되면 바로 켜집니다.
지금 에이전트에게 줄 것
| 리소스 | 주소 | 용도 |
|---|---|---|
| OpenAPI | /docs/openapi.yaml | 모든 엔드포인트, 필드, 오류. 도구 생성기와 스펙을 읽는 에이전트용 |
| 문서 색인 | /docs/llms.txt | 이 문서와 모든 모델을 담은 짧은 안내. 언어 모델용으로 작성 |
| 전체 문서 | /docs/llms-full.txt | 모든 페이지를 하나의 Markdown 파일로 |
| 한 페이지 | /docs/markdown/<page> | 한 페이지의 Markdown. 각 페이지의 Copy page 버튼이 주는 것과 같습니다 |
코딩 에이전트에서 잘 통하는 프롬프트(에이전트에게는 영어가 가장 확실합니다):
Use the PopNow API (OpenAPI: https://popnow.ai/docs/openapi.yaml,
docs: https://popnow.ai/docs/llms.txt). My key is in the POPNOW_API_KEY
environment variable; never print it or write it to a file.
Before you create anything, call POST /api/v1/jobs/quote and tell me the
price in credits (1 credit = $0.01). Send an Idempotency-Key with every
createTask, and wait for the result with ?wait=60 or by polling recordInfo.에이전트를 안전하게
- 에이전트에게는 전용 키를 주고, 필요한 모델만 허용하고 일일 지출 한도를 거세요(인증). 문제가 생기면 그 키 하나만 폐기하면 됩니다.
- 비싼 작업, 특히 영상을 돌리기 전에 견적부터 받게 하세요.
- 키는 대화가 아니라 환경 변수에 두세요. 에이전트는 들은 내용을 그대로 되풀이하기도 합니다.
MCP 서버가 열리면
MCP 서버는 이 사이트의 모든 것과 같은 API 키와 크레딧을 쓰며, 도구는 여기 문서화된 엔드포인트(모델 고르기, 견적, 생성, 결과 기다리기, 내려받기)와 일대일로 대응합니다. 지금 REST API로 만든 것은 바꿀 필요 없이 계속 동작합니다.