MCP 표준 생성 워크플로

제공 상태 확인

공식 MCP는 https://api.animgen.com/mcp에서 공개 베타로 운영됩니다. OAuth와 인증 계정으로 클라이언트 설정을 완료하세요. 연결·모델 조회는 유료 생성 승인이 아닙니다.

1. 모델 조회

미리보기 기반 구간 선택, FPS 변경, 원본 재사용은 단계별 구간 및 FPS 워크플로를 따르세요. quote_video_generation → generate_video → get_video_generation → preview_video → quote_animation_export → export_animation → get_animation_export입니다. 유료 생성마다 별도 승인을 받고 동영상 에셋 ID를 후속 내보내기에 재사용하세요. 아래는 원클릭 프레임 수 방식입니다.

빈 객체로 list_models를 호출하고 실제 반환 ID와 지원 설정을 선택하세요. 모든 모델의 끝 프레임, 참조 이미지, 네거티브 프롬프트, 시드, 길이·비율 지원이 같다고 가정하지 마세요.

2. 로컬 이미지 전송

로컬 경로는 ImageInput이 아닙니다. 업로드 브리지는 세 단계입니다.

1. filename, mime_type, 정확한 byte_size로 prepare_image_upload를 호출합니다.
2. expires_at 전에 반환된 HTTP method, upload_url, headers로 실제 바이트를 전송합니다. 승인된 클라이언트 기능이 수행하며 MCP에 경로를 제공하는 것으로 대신할 수 없습니다.
3. upload_id로 complete_image_upload를 호출하고 반환 file_id를 생성 요청에 사용합니다.

업로드 대상에 MCP 토큰·API 키를 추가하지 마세요. 반환된 업로드 헤더만 사용하고 URL을 민감 정보로 다루세요. 바이트 전송이 불가능하면 승인된 지원 기능, 허용된 공개 HTTPS 이미지, 한도 내 Base64를 사용하세요. 업로드 성공을 가장하지 마세요.

3. 요청 구성 및 견적

다음은 quote_animation 인수 구조입니다. UUID는 완료 업로드의 file_id로 바꾸고 실제 모델·지원 옵션을 설정하세요.

{
  "request": {
    "input": {
      "first_frame": {
        "type": "file",
        "file_id": "00000000-0000-4000-8000-000000000001"
      }
    },
    "prompt": "A character runs in place, side view, fixed camera.",
    "selection": {"mode": "full"},
    "export": {
      "output_formats": ["frames_zip"],
      "frame_count": 24,
      "output_width": 512,
      "output_height": 512
    }
  }
}

결과에는 quote_id, credits, breakdown, expires_at이 있습니다. 견적은 생성을 시작하지 않습니다. 사용자에게 출력·비용을 설명하고 다음 단계 전에 승인받으세요.

4. 승인 후에만 생성

동일 request, 저장한 idempotency_key, 승인된 quote_id 및/또는 max_credits로 generate_animation을 호출하세요. 이 세 필드는 request 내부가 아닌 옆에 있는 도구 인수입니다.

적절하면 최신 견적과 상한을 함께 사용하세요. 상한은 AI가 임의로 만든 금액이 아니라 사용자 승인에서 나와야 합니다. 재시도 구현 전에 지출 안전장치를 읽으세요.

반환 작업 ID를 저장하세요. 작업은 비동기이며 완료된 다운로드가 아닙니다.

5. 종료 상태까지 조회

animation_id로 get_animation을 호출하세요. 약 5초에서 시작하는 제한된 간격과 기한을 사용하세요. 결과는 구조화 JSON이며 MCP 전송이 API HTTP Retry-After를 노출한다고 가정하지 마세요.

queued, running, cancelling 동안 계속 조회하고 succeeded, failed, cancelled에서 멈추세요. 실패해도 outputs를 확인하세요. 내보내기 실패 시 원본 동영상이 있을 수 있습니다.

6. 실제 바이트 다운로드

각 유용한 에셋의 asset_id로 download_asset을 호출하세요. 메타데이터·서명 URL을 반환하며 자동 로컬 저장은 아닙니다.

OAuth·API 인증 정보를 전달하지 않고 승인된 다운로드 기능을 사용하세요. 파일을 비공개 저장하고 서명 URL 원문 대신 로컬 위치나 적절한 첨부를 제공하세요. 만료 시 download_asset으로 갱신하세요.

취소가 필요하면 animation_id로 cancel_animation을 호출한 뒤 조회하세요. 취소는 최선 노력이며 전액 환불을 의미하지 않습니다.