Model Context Protocol

AI 에이전트에서 ToAPIs로 이미지와 동영상 생성

MCP로 평소 쓰는 에이전트에 ToAPIs를 연결하세요. API 키를 복사하는 대신 브라우저로 로그인해 승인합니다. 에이전트가 모델을 고르고, 파라미터를 확인하고, 작업을 제출해 결과를 가져옵니다.

  • 200개 이상의 모델
  • 브라우저 승인
  • 사용 한도가 있는 전용 키
  • API와 같은 가격

Connect

클라이언트를 고르고 몇 단계로 연결하세요

MCP 엔드포인트

https://api.toapis.com/mcp

  1. 1

    이 프롬프트를 Claude Code에 보내기

    Claude Code는 명령을 실행하기 전에 매번 물어봅니다. 허용하세요.

    ToAPIs를 Claude Code에 연결해서 이미지와 동영상을 생성할 수 있게 해 줘.
    1. ToAPIs 스킬 설치: `npx skills add toapis/skills -g --agent claude-code -y`. npx를 찾을 수 없으면 먼저 이 시스템의 표준 방식으로 Node.js LTS(npx 포함)를 설치해. 설치 후에도 npx를 찾을 수 없으면 Node.js 설치 경로의 전체 경로로 실행해. Node.js를 설치할 수 없으면(관리자 비밀번호가 필요하거나 차단된 경우 등) 이 단계를 건너뛰고 계속 진행한 뒤, 마지막에 Node.js를 설치하고 나서 스킬을 설치하라고 알려 줘.
    2. ToAPIs MCP 서버 추가: `claude mcp add --transport http --scope user toapis https://api.toapis.com/mcp --header "X-Locale: ko"`
    3. /mcp를 입력하고 toapis를 선택해 브라우저에서 승인하라고 안내해 줘(목록에 toapis가 없으면 먼저 Claude Code를 다시 시작). 내가 끝났다고 말하면 `claude mcp list`를 실행해서 toapis가 Connected로 표시되는지 확인해. 아니라면 표시된 상태를 알려 주고 문제를 찾는 걸 도와줘.
  2. 2

    /mcp에서 승인

    Claude Code에서 /mcp를 입력하고 toapis를 선택한 뒤 브라우저에서 로그인하세요. 목록에 toapis가 없으면 먼저 Claude Code를 다시 시작하세요.

  3. 3

    연결 확인

    새 대화에서 아래 문장을 보내세요. 잔액이 보이면 연결된 것입니다(조회는 무료). 로그인을 요구하거나 인증에 실패하거나 ToAPIs 도구를 찾지 못하면 위 단계를 다시 확인하세요.

    ToAPIs 크레딧이 얼마나 남았고 오늘 얼마나 썼어?
  4. 4

    만들기 시작

    원하는 이미지나 동영상을 그대로 말하세요. 예:

    ToAPIs로 새벽 등대 이미지를 16:9로 생성해 줘

Capabilities

연결하면 할 수 있는 일

원하는 것을 평소 말투로 설명하세요. 에이전트가 모델을 고르고, 문서에 맞춰 파라미터를 준비하고, 작업을 제출해 끝까지 확인합니다.

이미지 생성

텍스트로 이미지 생성, 참조 이미지 편집, 비율과 개수 지정.

ToAPIs로 새벽 등대 이미지를 16:9로 생성해 줘

도구: generate_image

동영상 생성

텍스트로 동영상, 이미지로 동영상 생성. 기본 추천 모델은 Seedance입니다.

이 제품 사진을 5초짜리 세로형 홍보 영상으로 만들어 줘

도구: generate_video

로컬 파일 사용

로컬 이미지 경로를 알려 주면 에이전트가 업로드해 참조 이미지로 사용합니다.

./product.png를 참고해서 제품을 흰색 배경에 놓아 줘

도구: create_upload

계정 확인

잔액, 최근 작업, 작업이 실패한 이유, 오늘 사용한 금액.

ToAPIs 크레딧이 얼마나 남았고 오늘 얼마나 썼어?

도구: get_balance / get_usage

Why MCP

API 키를 복사할 필요 없음

브라우저로 로그인해 승인하세요. 연결에는 선택한 키가 쓰이며, 키가 에이전트 설정이나 대화에 나타나지 않습니다.

사용 금액 관리

연결용으로 사용 한도가 있는 전용 키를 만들 수 있고, 콘솔의 '연결된 앱'에서 언제든 연결을 해제할 수 있습니다.

API와 같은 가격

일반 모델 가격으로 크레딧에서 차감되며, 실패한 작업은 기존 규칙에 따라 환불됩니다.

한 번 연결로 모든 모델

GPT Image, Nano Banana, Seedance, Kling 등 200개 이상의 모델. 새 모델도 출시되는 즉시 사용할 수 있습니다.

자주 묻는 질문

Curated high-frequency questions. Click any question to expand the answer. Use the button below to rotate questions.

복사할 필요는 없습니다. 승인할 때 ToAPIs 페이지에서 기존 키를 고르거나 전용 키를 만들면, 에이전트가 액세스 토큰을 통해 그 키를 사용합니다. 헤더 인증만 지원하는 클라이언트는 API 키로 연결할 수도 있습니다.

API를 직접 호출할 때와 같이 모델 가격이 선택한 키와 계정 크레딧에서 차감됩니다. 모델 목록, 잔액, 작업 조회는 무료이며 이미지와 동영상 생성만 과금됩니다.

스킬 설치와 MCP 서버 추가는 컴퓨터의 Codex 설정에 기록되는데, 기본 권한 모드에서는 에이전트가 워크스페이스 밖의 파일을 바꿀 수 없습니다. 설정할 때만 필요하며 끝나면 되돌릴 수 있습니다. 터미널에서 명령을 직접 실행해도 됩니다.

콘솔의 '연결된 앱'에서 연결을 해제하세요. 승인이 취소되고, 이 연결용으로 만든 전용 키도 비활성화됩니다(다른 연결에서 사용 중인 경우 제외). 클라이언트에서 toapis를 삭제하는 것(예: codex mcp remove toapis)은 로컬 설정만 지웁니다.

두 사이트는 계정과 크레딧이 따로 관리됩니다. toapis.com 계정은 api.toapis.com/mcp를, toapis.cn 계정은 api.toapis.cn/mcp를 사용합니다. 다른 사이트에서 로그인하면 사이트가 일치하지 않는다는 안내가 표시됩니다.

원격 MCP와 OAuth를 지원하는 데스크톱·명령줄 클라이언트는 대부분 '기타 클라이언트' 방법으로 연결할 수 있습니다. 승인이 실패하면 API 키로 연결하세요. 더 많은 클라이언트의 안내를 계속 추가할 예정입니다.

ToAPIs를 에이전트에 연결하세요

가입하면 바로 시작할 수 있습니다. 연결한 뒤에는 대화 안에서 이미지와 동영상을 생성하세요.