MCP

MCP를 지원하는 AI 앱에 Zet Studio를 연결하면, 대화하면서 이미지와 영상을 만들 수 있어요. REST API와 같은 가격과 규칙을 쓰고, 금액은 같은 잔액에서 빠져요.

주소

주소마다 인증 방식이 하나예요. 다른 방식을 보내면 401로 거절해요.

쓰는 곳	주소	인증
Claude, ChatGPT 같은 앱	`https://mcp.studio.thezet.io/mcp`	로그인
서버와 스크립트	`https://api.studio.thezet.io/mcp`	API 키

앱별 연결 방법은 연결 안내 페이지에 있어요. 앱에서 로그인할 때는 승인받은 계정을 써 주세요.

작업이 오래 걸린다고 다시 시작하지 마세요. generation_wait가 wait_slice_expired: true로 답하면 같은 ID로 다시 기다려요.

도구	하는 일	권한
`models_explore`	모델과 가격을 봐요. `model`을 주면 옵션과 전체 가격을 줘요.	읽기
`balance`	잔액과 동시 실행 한도를 봐요. 연결 확인에도 써요.	읽기
`generation_status`	작업 상태를 결과 없이 봐요.	읽기
`generation_wait`	작업이 끝나길 기다려요.	읽기
`generation_result`	작업과 결과 링크를 봐요.	읽기
`generations_list`	API와 MCP로 만든 작업을 최신순으로 봐요.	읽기
`usage`	기간별 작업 수와 금액을 봐요.	읽기
`generate_image`	이미지를 만들어요.	지출
`generate_video`	영상을 만들어요.	지출
`generation_cancel`	시작 전인 작업을 취소하고 금액을 돌려받아요.	쓰기
`media_upload`	입력 이미지를 올릴 주소를 받아요.	쓰기
`media_confirm`	올린 파일을 확인해요. 이후 입력으로 쓸 수 있어요.	쓰기

MCP로는 작업이나 파일을 지울 수 없어요. 지우려면 REST API를 써 주세요.

generate_image와 generate_video에는 세 가지가 있어요.

값	뜻
`idempotency_key`	필수예요. 같은 키로 다시 보내면 첫 작업을 돌려주고 다시 청구하지 않아요. 자세한 내용은 중복 방지를 봐 주세요.
`dry_run`	`true`면 요청을 검사하고 가격만 알려줘요. 아무것도 시작하지 않고 키도 쓰지 않아요.
`max_spend_usd`	작업 가격이 이 금액을 넘으면 시작하지 않아요.

generation_wait는 한 번에 작업 20개까지, 최대 55초 기다려요.

값	뜻
`ids`	작업 ID예요. 1~20개를 넣어요.
`wait_for`	`all`(기본)은 모두 끝날 때까지, `any`는 하나라도 끝날 때까지 기다려요.
`timeout_seconds`	이번에 기다릴 시간이에요. 1~55초이고 기본은 50초예요.
`include_results`	`false`면 결과 없이 상태만 줘요.

앱은 잔액으로 이미지와 영상을 만들 수 있어요. 설정의 연결된 앱에서 앱마다 정할 수 있어요.

바꾼 내용은 바로 적용돼요. 앱이 도구 목록을 저장해 두었다면 다시 연결해야 목록이 바뀌어 보여요.

도구가 거절하면 REST API와 같은 형식의 오류를 돌려줘요. MCP에서만 나오는 코드는 오류 목록에 있어요.