개발자와 AI 에이전트를 위해

내 스택을 위한 하나의 이미지·영상 API, 그리고 Claude와 에이전트를 위한 네이티브 MCP

텍스트 투 이미지, 이미지 편집, 배경 제거, 아바타, 영상을 단일 REST API로 호출하거나, DesignerBox를 MCP로 Claude와 에이전트에 바로 연결하세요. 요청마다 모델을 고르고, clientRequestId로 멱등 작업을 제출하며, 촬영 건당이 아닌 크레딧 단위로 지불합니다.

API 키 받고 무료로 시작하기

모든 생성 작업을 하나의 API로

텍스트 투 이미지, 편집, 배경 제거, 아바타, 영상을 일관된 하나의 요청 형태로.

2,Nano Banana Pro, Nano Banana GPT Image 2, Seedream 5, Flux 중에서 요청마다 모델을...

5,Nano Banana Pro, Nano Banana 2, GPT Image 2, Seedream Flux 중에서 요청마다 모델을...

15FREE 등급으로 시작해 호출량이 늘면 달러에서 200달러까지 확장할 수 있습니다

이미지 생성, 편집, 처리

텍스트 투 이미지(generate_image), 이미지 편집(edit_image), 배경 제거(remove_background), 아바타(create_avatar), 영상(generate_video)을 일관된 하나의 요청 형태로 호출하세요. 자체 GPU 파이프라인을 구축하지 않고도 프로덕션에 바로 쓸 수 있습니다.

요청마다 모델 선택

호출마다 알맞은 엔진으로 라우팅하세요. Nano Banana Pro(14cr)는 고해상도 실사와 텍스트 렌더링에서 앞서고, Seedream 5(4cr)와 Nano Banana 2(7cr)는 정밀도를 낮추는 대신 가격이 유리하며, GPT Image 2(22cr)와 Flux(Pro 1.1은 5cr, Flux 2 Flex는 7cr)가 카탈로그를 채웁니다.

AI 에이전트와 Claude를 위한 MCP

mcp.designerbox.ai에서 DesignerBox를 에이전트가 직접 호출하는 도구로 노출하세요. MCP는 LLM에 외부 도구용 범용 JSON-RPC 인터페이스를 제공하고 주요 에이전트 플랫폼에서 지원되므로, 에이전트 스택의 이식성이 유지됩니다.

같은 API 안의 영상 생성

이미지에 쓰던 인증, 작업 모델, 웹훅 그대로 generate_video로 영상을 생성하세요. 별도 연동이 필요 없어, 이미지 호출과 동일한 배관 위에서 영상 기능이 제품에 들어갑니다.

API 키에서 첫 결과물까지

가입에서 완성된 이미지 또는 영상 URL까지, 간단한 흐름.

키 발급받고 경로 정하기

FREE 등급으로 가입해 대시보드에서 API 키를 받은 뒤, DesignerBox를 어떻게 호출할지 정하세요. 백엔드 서비스라면 REST, Claude Desktop과 Cursor, 에이전트 런타임이라면 MCP 서버입니다.

작업 제출하기

프롬프트나 소스 이미지를 모델과 clientRequestId와 함께 POST하세요. 오래 걸리는 생성 작업이라도 API가 즉시 작업 ID를 반환하므로 요청 스레드가 멈추지 않습니다.

알림 받기, 또는 폴링하기

작업이 끝나면 웹훅을 받거나, 작업 엔드포인트를 주기적으로 폴링해 상태를 맞추세요. 웹훅은 지연이 짧은 알림으로, 폴링은 보장 수단으로 쓰면 됩니다.

결과물 가져오기

완성된 이미지나 영상 URL을 받아 저장하고 제품, CMS, 파이프라인으로 흘려보내세요. 같은 clientRequestId로 다시 요청하면 작업을 재실행하지 않고 동일한 결과를 반환합니다.

확장하고 최적화하기

대시보드에서 크레딧 사용량을 확인하고, 비용이나 품질이 타당한 곳에서 모델을 바꾸며, 처리량이 늘면 상위 등급으로 옮기세요. 아키텍처를 다시 짤 필요는 없습니다.

프로덕션 연동을 위한 설계

인증과 키 관리

팀 단위로 스코프가 지정된 베어러 API 키로 인증합니다. 대시보드에서 키를 교체하고, 스테이징과 프로덕션 키를 분리해 사용량과 한도를 깔끔하게 관리하세요.

멱등성 있는 작업 제출

클라이언트에서 고유값을 만들어 clientRequestId로 보내세요. 서버가 이 값을 기록하므로 재시도되거나 중복된 요청도 다시 과금하지 않고 원래 응답을 반환합니다. 안전하게 재시도 가능한 API의 표준 패턴입니다.

웹훅과 상태 폴링

완료 이벤트용 웹훅 URL을 등록하고, 보완책으로 주기적 폴링을 더하세요. 재시도 윈도우보다 긴 TTL로 이벤트 ID를 추적하면 중복 전달이 걸러집니다.

모델 카탈로그와 파라미터

모든 요청은 모델과 함께 해상도, 화면비, 편집 마스크, 참조 이미지 같은 모델별 파라미터를 받습니다. 이미지 모델은 Nano Banana Pro(14cr), Nano Banana 2(7cr), GPT Image 2(22cr), Seedream 5(4cr), Flux(Pro 1.1은 5cr, Flux 2 Flex는 7cr)를 아우르고, 영상은 generate_video로 처리합니다.

MCP 서버 연동

mcp.designerbox.ai의 DesignerBox MCP 서버를 Claude Desktop, Cursor, 또는 직접 만든 에이전트 루프에 연결하세요. 에이전트가 generate_image, edit_image, remove_background, create_avatar, generate_video 같은 도구를 네이티브로 호출하며, 크레딧과 한도는 REST API와 동일합니다.

크레딧, 한도, 등급

사용량은 크레딧으로 측정됩니다. FREE($0)는 연동과 테스트용이고, BASIC($15 / 500cr), PRO($35 / 1000cr), PREMIUM($75 / 2500cr), ULTRA($200 / 8000cr)가 처리량에 따라 확장됩니다. 대량 배치 실행 전에는 API로 현재 플랜 한도를 확인하세요.

개발자 API와 MCP 자주 묻는 질문

제 애플리케이션에서 이미지를 생성하려면 어떻게 하나요?

가입해 API 키를 받고, 프롬프트를 모델 및 clientRequestId와 함께 생성 엔드포인트로 POST하면 됩니다. 오래 걸리는 작업은 작업 ID가 즉시 반환되며, 이후 웹훅을 받거나 작업 엔드포인트를 폴링해 완성된 결과물 URL을 얻습니다. 이미지 편집, 배경 제거, 아바타, 영상 모두 동일한 요청 형태를 씁니다.

MCP란 무엇이고 DesignerBox는 왜 지원하나요?

MCP(Model Context Protocol)는 Anthropic이 2024년 말에 공개한 개방형 표준으로, LLM에 외부 도구용 범용 인터페이스를 제공합니다. DesignerBox는 mcp.designerbox.ai에 MCP 서버를 제공해 Claude를 비롯한 에이전트가 이미지와 영상 생성을 네이티브 도구로 호출할 수 있게 합니다. 공개 이후 에이전트 플랫폼 전반에서 빠르게 채택되고 있습니다.

멱등 작업은 이중 과금을 어떻게 막나요?

고유한 clientRequestId를 만들어 요청마다 함께 보냅니다. 서버가 그 값을 기록하므로 같은 clientRequestId로 재시도하면 작업을 다시 실행하거나 과금하지 않고 원래 응답을 반환합니다. 덕분에 네트워크 재시도와 최소 1회 전달 웹훅을 안전하게 쓸 수 있습니다.

어떤 모델을 호출할 수 있고, 요청마다 바꿀 수 있나요?

네, 모델 선택은 요청 단위입니다. 이미지는 Nano Banana Pro(14cr), Nano Banana 2(7cr), GPT Image 2(22cr), Seedream 5(4cr), Flux(Pro 1.1은 5cr, Flux 2 Flex는 7cr)로 라우팅할 수 있고, 영상은 generate_video로 이용합니다. 모델마다 품질, 속도, 비용의 균형이 달라서 Nano Banana Pro는 실사와 텍스트 렌더링에서 앞서고 Seedream 5는 가격이 더 낮습니다.

요금과 크레딧 사용은 어떻게 되나요?

사용량은 등급별로 크레딧으로 측정됩니다. FREE $0, BASIC $15(500cr), PRO $35(1000cr), PREMIUM $75(2500cr), ULTRA $200(8000cr)입니다. 생성당 크레딧 비용은 선택한 모델과 해상도에 따라 달라집니다. 대량 배치 실행을 시작하기 전에 API로 플랜 한도를 조회할 수 있습니다.