MCP(모델 컨텍스트 프로토콜)
MCP 도구 레퍼런스
현재 FoxCut MCP 도구와 요금 적용 방식, 결과 계약을 설명합니다.
읽기 전용 도구
| 도구 | 용도 |
|---|---|
| account_status | 요금제, 상태, 정체성 및 크레딧 잔액 |
| list_models | 모델 기능 및 요금 |
| list_workflows | 작업별 워크플로 카탈로그 |
| list_presets | 모션, 스타일 및 마케팅 프리셋 |
| list_voices | 독립 음성 및 토킹 아바타 음성 옵션 |
| estimate_generation_cost | 제출 전 크레딧 견적 |
| get_generation | 작업 하나의 상태 및 결과물 |
| list_generations | 최근 작업 |
| list_assets | 생성 미디어 |
| list_characters | 재사용 가능한 정체성 |
H3 MAX 레퍼런스 동영상 생성
model=minimax-h3-max, video_mode=reference와 reference_image_urls, reference_video_urls 또는 reference_audio_urls를 지정해 generate_video를 사용하세요. 먼저 미디어를 가져오거나 업로드하고 반환된 상대 에셋 콘텐츠 URL을 전달합니다. 레퍼런스는 정체성, 스타일, 움직임 또는 사운드를 안내하며 시작/종료 프레임이 아닙니다.
- 이미지 최대 9개, 동영상 클립 3개, 오디오 클립 3개를 사용할 수 있으며 전체 파일은 최대 12개입니다. 동영상/오디오 클립은 각각 2~15초이고 각 미디어 유형의 총 길이는 15초입니다. 오디오를 사용하려면 이미지 또는 동영상이 하나 이상 필요합니다.
- 에셋에 목록 순서대로 Image 1, Image 2, Video 1, Audio 1 이름을 지정하세요. 각 역할과 동작, 컷, 대사별 발화 캐릭터를 설명하세요. 이 지침을 따른 결과가 보장되지는 않습니다.
- 레퍼런스 모드에서 시작/종료 프레임, 캐릭터 ID, 스타일/카메라 프리셋 또는 단수형 reference_video_url(Kling 모션 전송)을 함께 사용하지 마세요.
- kind=t2v와 params.videoMode=reference, referenceImageUrls, referenceVideoUrls, referenceAudioUrls, durationSec, resolution, aspect를 지정해 견적을 내세요. 레퍼런스 비용이 포함되며 검증된 에셋 메타데이터를 읽습니다. 클라이언트 토큰 수는 무시됩니다.
- 480p 또는 768p, list_models에 있는 길이/화면 비율, standard 또는 draft 품질을 사용하세요. 생성 시 견적된 크레딧이 예약되고 폴링할 작업 ID가 반환됩니다.
생성 도구
| 도구 | 동작 |
|---|---|
| generate_image | 텍스트-이미지 생성 또는 이미지 편집 작업을 대기열에 추가 |
| generate_video | 텍스트/이미지/레퍼런스/모션 기반 동영상 생성 작업을 대기열에 추가 |
| generate_audio | 독립 WAV 음성 생성 작업을 대기열에 추가하며 출력된 UTF-8 바이트 수에 따라 2~8크레딧을 사용 |
| generate_speech | 토킹 아바타 동영상 생성 작업을 대기열에 추가 |
| edit_media / upscale_media | 원본을 변경하지 않는 파생 작업 |
| run_product_photoshoot | 상업용 이미지 모드 |
| create_marketing_video | UGC, 데모, 리뷰 및 광고 모드 |
| create_brand_asset | 선택한 브랜드 시스템 결과물 1개 |
| create_marketplace_cards | 커머스 카드 1개 이상 생성 |
| create_video_explainer | 내레이션 장면 또는 편집된 설명 영상 |
| create_youtube_thumbnail | 16:9 또는 세로형 커버 이미지 |
| create_character / train_character | 정체성 초안을 만들고 학습 |
| create_moodboard | 재사용 가능한 비주얼 방향 저장 |
| cancel_generation | 가능한 작업을 중단하며 에셋은 삭제하지 않음 |