API와 MCP 서버

API 키로 Claude, Cursor 또는 내 스크립트에서 생성하세요: 같은 모델, 같은 크레딧, 실패는 환불됩니다.

캔버스 밖의 Imaginode

캔버스가 생성할 수 있는 모든 것은 캔버스 밖에서도 이용할 수 있습니다. REST API와 MCP 서버(Model Context Protocol)를 통해 AI 에이전트나 스크립트가 내 계정으로 이미지와 비디오를 만들 수 있습니다. 호출은 잔액의 크레딧을 캔버스와 같은 가격으로 소비하고, 실패한 생성은 언제나처럼 자동으로 환불됩니다.

MCP는 AI 어시스턴트(Claude, Cursor 등 다수)가 외부 도구를 쓰게 해 주는 표준입니다. Imaginode를 연결하면 어시스턴트가 대화 도중에 이미지를 생성하거나, 쓰고 있는 글에 삽화를 넣거나, 자동화된 워크플로우의 비주얼을 만들 수 있습니다.

API 키 만들기

내 프로필의 'API 키' 섹션으로 가세요. 키에 이름을 붙이고('Claude Code', '블로그 스크립트' 등) 생성하세요. imk_… 시크릿은 딱 한 번만 표시되니 즉시 복사하세요. 활성 키는 최대 5개이고 언제든 클릭 한 번으로 폐기할 수 있습니다. 폐기된 키는 즉시 작동을 멈춥니다.

키를 만들려면 이메일 인증이 필요하고, 키마다 분당 10회 생성으로 제한됩니다. 편하게 작업하기엔 충분하지만, 에이전트가 폭주해도 실수로 잔액을 다 써 버릴 수는 없는 수준입니다.

MCP 서버 연결하기

서버 주소는 https://imaginode.ai/api/mcp(Streamable HTTP 전송)입니다. 'Authorization: Bearer imk_…' 헤더에 키를 담아 인증하세요. Claude Code에서는 명령 하나면 됩니다: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer 내-키". Claude.ai나 Cursor에서는 같은 주소와 같은 헤더로 커스텀 커넥터를 추가하세요.

노출되는 도구는 4개입니다. list_models는 카탈로그와 크레딧 단위 가격을 반환합니다. generate_image는 이미지를 만들고 결과를 기다립니다. URL이 바로 반환됩니다. generate_video는 비디오 생성을 시작하고 추적용 ID를 반환합니다. get_generation_status는 최종 URL이 나올 때까지 생성을 추적합니다.

REST API 직접 쓰기

스크립트라면 엔드포인트 3개로 충분합니다. GET /api/models는 모델과 옵션, 가격을 인증 없이 나열합니다. POST /api/generate는 생성을 시작합니다. model, prompt와 모델 옵션(duration, resolution, aspectRatio, audio, imageUrls)을 담은 JSON을 Authorization 헤더의 키와 함께 보내면, 응답에 requestId, cost, 새 잔액이 담겨 옵니다. GET /api/generate/status?requestId=…는 running을 반환하고, 이어서 출력 URL이 담긴 completed 또는 환불과 함께 failed를 반환합니다.

입력 이미지(imageUrls)는 Imaginode 계정에 호스팅된 미디어여야 합니다. 먼저 내 미디어에 가져오거나, 이전 생성의 URL을 재사용하세요.

베스트 프랙티스

프리미엄 모델로 넘어가기 전에 경제적인 모델(Flux Schnell, 1크레딧)로 프롬프트를 검증하세요. 비디오는 30초마다 상태를 확인하세요. 보통 1~5분, 긴 생성은 최대 30분까지 걸립니다. 정확한 비용은 결과가 나오기도 전에, 시작 시점에 바로 반환됩니다.

키는 비밀입니다. 저장소에 커밋하지 말고 공유하지도 마세요. 조금이라도 의심되면 프로필에서 폐기하고 새로 만드세요.