영카트 기반 쇼핑몰을 운영하거나 외주 개발하는 분이라면 이 요구를 받아봤을 것이다. "상품 영상도 넣어주세요." 그리고 그 다음에 오는 현실: 촬영 장비도 없고, 영상 편집 인력도 없고, 상품 수는 수백 개.

2026년 7월 31일, 상하이 AI 기업 MiniMax(홍콩증시 100)가 공개한 영상 생성 모델 H3는 이 문제를 API 레벨에서 해결할 수 있는 가능성을 열었다. 상품 사진 한 장을 입력하면 4~15초의 짧은 영상을 자동 생성하되, 32kHz 스테레오 음성까지 한 번에 나온다.

이 글에서는 그누보드/영카트 환경에서 미니맥스 H3 API를 연동해 상품 영상을 자동 생성하고 상품 상세 페이지에 삽입하는 구현 방법을 정리한다.

전체 아키텍처 개요

구현의 흐름은 간단하다.

1. 상품 등록 시 상품 대표 이미지를 서버에 업로드 (기존 영카트 플로우)
2. 백그라운드에서 대표 이미지를 H3 API에 전송
3. API가 반환한 MP4 영상 파일을 서버에 저장
4. 상품 상세 페이지에서 영상이 있으면 이미지 대신 영상을 autoplay로 표시

처리는 비동기로 해야 한다. API 호출부터 영상 수신까지 90~150초 걸리므로, 상품 등록 시 즉시 표시되지 않고 생성 완료 후 상세 페이지에 반영되는 구조가 맞다.

API 호출 구현 (PHP)

그누보드/영카트는 PHP 기반이므로 cURL을 사용한 API 호출 예시를 작성한다.

<?php
function generate_product_video($image_path, $product_name) {
    // 이미지를 base64로 인코딩
    $image_data = base64_encode(file_get_contents($image_path));

    $payload = json_encode([
        'model' => 'minimax-h3',
        'prompt' => "Product showcase: gentle rotation effect, "
                   . "soft studio lighting shift, clean white background, "
                   . "subtle reflection on surface",
        'image' => $image_data,
        'duration' => 6,
        'resolution' => '1080p'
    ]);

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => 'https://api.minimax.io/v1/video/generate',
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $payload,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . MINIMAX_API_KEY
        ],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 300 // 5분 타임아웃
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}
?>

주의: 위 코드는 구조 예시이며, 실제 API 엔드포인트와 파라미터는 MiniMax 공식 문서를 확인해야 한다. 인증 방식, 응답 구조, 에러 핸들링은 API 문서 기준으로 구현할 것.

비동기 처리 구현

상품 등록 시점에서 동기적으로 API를 호출하면 관리자 페이지가 2분 이상 멈추므로, 큐 기반 비동기 처리가 필수.

방법 1: 크론 + DB 큐 (그누보드 친화적)

상품 등록 시 g5_video_queue 테이블에 작업을 INSERT하고, 1분 간격 크론이 큐에서 미처리 건을 꺼내 API를 호출하는 방식.

CREATE TABLE g5_video_queue (
    vq_id INT AUTO_INCREMENT PRIMARY KEY,
    it_id VARCHAR(20) NOT NULL,
    image_path VARCHAR(255) NOT NULL,
    status ENUM('pending','processing','done','failed') DEFAULT 'pending',
    video_path VARCHAR(255) DEFAULT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

크론 스크립트가 status = 'pending'인 행을 하나씩 처리하고, 성공 시 video_path에 저장 경로를 기록한 뒤 status = 'done'으로 업데이트.

방법 2: Webhook 콜백

API가 Webhook을 지원하면 호출 시 콜백 URL을 전달하고, 생성 완료 시 MiniMax 서버가 콜백으로 영상 URL을 보내주는 방식. 크론 없이도 실시간 반영 가능. API 문서에서 Webhook 지원 여부를 확인.

상세 페이지 영상 삽입

영카트 상품 상세 페이지 스킨(예: item.skin.php)에서 영상 존재 여부를 체크하고 표시하는 로직.

<?php
$video_row = sql_fetch("SELECT video_path FROM g5_video_queue 
                        WHERE it_id = '{$it_id}' AND status = 'done' 
                        LIMIT 1");

if ($video_row && $video_row['video_path']) {
    echo '<video autoplay muted loop playsinline 
                 style="width:100%; max-width:600px;">
            <source src="' . $video_row['video_path'] . '" type="video/mp4">
          </video>';
} else {
    // 기존 상품 이미지 표시
    echo '<img src="' . $it['it_image1'] . '" alt="' . $it['it_name'] . '">';
}
?>

muted와 autoplay를 함께 사용해야 모바일 브라우저에서 자동재생이 된다. H3가 생성한 네이티브 음성을 들려주고 싶다면 muted를 빼되, iOS Safari에서는 사용자 인터랙션 없이 유성 자동재생이 차단되므로 재생 버튼 UI를 별도로 추가하는 것이 안전하다.

비용 분석

API 가격: 1080p 기준 초당 약 $0.10 (추정), 6초 영상 1건 = $0.60 (약 ₩820).

3회 생성 후 최적 결과 선택 = ₩2,460/상품.

외주 대비 약 1/20 수준. 물론 AI 생성 영상의 품질이 전문 촬영과 동등하지는 않지만, "영상이 없는 것"과 "있는 것"의 차이는 크다.

쇼핑몰 상품 페이지에서 영상이 있는 상품의 체류 시간이 2배 이상 높다는 데이터는 여러 이커머스 리서치에서 반복적으로 확인된다.

프롬프트 최적화 팁

상품 카테고리별로 프롬프트를 분기하면 결과가 좋아진다.

• 의류·패션: "fabric gently flowing, soft studio lighting, slight model movement" (단, 인체 특사는 피할 것)
• 식품: "steam rising, appetizing close-up, warm lighting, subtle food texture movement"
• 전자기기: "slow 360 rotation, clean reflections, minimal tech aesthetic"
• 가구·인테리어: "warm ambient light shifting, gentle camera drift, cozy atmosphere"

영카트 상품 카테고리 코드를 기반으로 프롬프트를 자동 매칭하는 함수를 만들면 완전 자동화가 가능하다.

한계와 주의사항

텍스트 왜곡. 상품 사진에 가격표, 브랜드명, 사이즈 태그가 있으면 영상에서 글자가 변형된다. 깨끗한 누끼 사진이나 순수 제품 사진을 사용할 것.

인물 사진 비추. 모델 착용샷은 얼굴이 변형되므로 사용하지 않는 것이 안전. 제품만 보이는 사진이 최적.

라이선스. H3 오픈웨이트는 한국이 기본 라이선스 제외 지역이므로 로컬 실행은 별도 허가 필요. API 사용은 이 제한에 해당하지 않음. Artificial Analysis 비디오 리더보드에서 경쟁 모델과의 비교도 참고.

결론

그누보드/영카트 기반 쇼핑몰에 AI 영상 생성 API를 연동하는 건 기술적으로 어렵지 않다. PHP cURL + 크론 큐 + 상세 페이지 스킨 수정, 세 가지면 된다.

어려운 건 "이걸 해야 하나?"라는 판단이다. 답은 상품 수와 운영 규모에 달렸다. 상품 50개 이상이고 영상 콘텐츠가 전혀 없는 쇼핑몰이라면, 12만 원으로 전 상품에 영상을 추가할 수 있다는 건 시도해볼 만한 투자다.