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에서는 같은 주소와 같은 헤더로 커스텀 커넥터를 추가하세요.

총 14개의 도구가 제공됩니다. list_models는 카탈로그, 각 모델이 하는 일과 크레딧 가격을 반환합니다; get_balance는 생성을 시작하기 전에 비용이 충당되는지 확인할 수 있도록 잔액을 읽어옵니다. list_templates와 get_template은 캔버스 템플릿을 설명합니다: 모델, 프롬프트, 연결, 예시, 그리고 바로 실행 가능한 상태로 열어주는 링크입니다. generate_image는 이미지를 생성하고 결과를 기다립니다: URL이 바로 반환됩니다. generate_video는 비디오(시작 이미지, 종료 이미지, 레퍼런스 이미지)를 시작하고 추적용 식별자를 반환합니다. generate_speech는 카탈로그의 음성 또는 복제된 음성 중 하나로 텍스트나 대화를 읽고, generate_sound는 음향 효과나 음악 트랙을 제작하며, enhance_audio는 오디오를 정리, 분리 또는 분할합니다. edit_image는 업스케일, 배경 제거 또는 사진을 3D 오브젝트로 변환하며; edit_video는 업스케일, 배경 제거, 연장, 음성 립싱크 또는 모션 전이를 수행합니다. list_voices와 list_characters는 사용자의 음성과 캐릭터를 읽어오고, get_generation_status는 생성 과정을 최종 URL까지 추적합니다. 서버는 2026-07-28 버전의 프로토콜뿐만 아니라 2025년의 핸드셰이크 버전들도 지원합니다: 오늘의 클라이언트와 미래의 클라이언트 모두 별도의 설정 없이 연결할 수 있습니다.

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분까지 걸립니다. 정확한 비용은 결과가 나오기도 전에, 시작 시점에 바로 반환됩니다.

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