Gemini Omni Video를 API로 사용하는 방법

Gemini Omni Flash는 Google의 저렴한 텍스트-투-비디오 모델로, Hypereal에서 간단한 REST API로 사용할 수 있습니다. 텍스트 프롬프트에서 720P 비디오 클립을 생성하며, 구독이나 전용 클라이언트 라이브러리가 필요 없습니다.

주요 사양:

• 해상도: 720P
• 길이: 6초 또는 10초
• 화면 비율: 16:9(가로) 또는 9:16(세로)
• 오디오 없음 — 비디오만
• 가격: 클립당 $0.1725(종량제, 고정 요금)

신규 계정에는 무료 크레딧이 제공되므로 비용 없이 엔드포인트를 테스트할 수 있습니다.

1. Hypereal 무료 계정 및 API 키 만들기

hypereal.cloud에 가입하고 대시보드의 Manage API Keys에서 키를 생성하세요.

환경 변수로 저장합니다:

export HYPEREAL_API_KEY="ck_..."

2. 첫 번째 비디오 생성하기

프롬프트와 파라미터를 포함하여 비디오 생성 엔드포인트에 POST 요청을 보냅니다:

curl -X POST https://hypereal.cloud/api/v1/videos/generate \
  -H "Authorization: Bearer $HYPEREAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini_omni_flash",
    "prompt": "a white cube rotating on a black background, clean product demo",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'

API는 job ID와 poll URL을 반환합니다:

{
  "jobId": "job_abc123",
  "pollUrl": "https://hypereal.cloud/api/v1/jobs/job_abc123"
}

비디오 생성은 비동기로 처리됩니다. pollUrl을 저장하고 다음 단계에서 결과를 가져오는 데 사용하세요.

3. 파라미터 — duration, resolution, aspect_ratio

파라미터	허용 값	비고
model	gemini_omni_flash	필수
prompt	임의 문자열	비디오 내용 설명
duration	6 또는 10	초 단위, 기본값 6
resolution	720P	유일하게 지원되는 해상도
aspect_ratio	16:9 또는 9:16	가로 또는 세로

제품 데모, 장면, 가로 촬영에는 16:9를 사용하세요. 모바일 최적화 또는 소셜 세로 클립에는 9:16을 사용하세요.

4. 결과 폴링하기

생성은 보통 30~90초 내에 완료됩니다. status가 "completed"가 될 때까지 job URL을 폴링합니다:

curl https://hypereal.cloud/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $HYPEREAL_API_KEY"

완료 시 응답:

{
  "jobId": "job_abc123",
  "status": "completed",
  "output": {
    "url": "https://cdn.hypereal.cloud/videos/job_abc123.mp4"
  }
}

url 필드에는 생성된 MP4 파일의 직접 링크가 포함됩니다. 다운로드하거나 직접 임베드하여 사용하세요.

Node.js에서 간단한 폴링 루프:

const delay = ms => new Promise(r => setTimeout(r, ms));

async function waitForVideo(jobId, apiKey) {
  const pollUrl = `https://hypereal.cloud/api/v1/jobs/${jobId}`;
  while (true) {
    const res = await fetch(pollUrl, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const data = await res.json();
    if (data.status === 'completed') return data.output.url;
    if (data.status === 'failed') throw new Error('Generation failed');
    await delay(5000);
  }
}

가격

모델	클립당 가격	길이 옵션	해상도
gemini_omni_flash	$0.1725	6초 또는 10초	720P

요금은 종량제로 초 단위가 아닌 클립 단위로 청구됩니다. 10초 클립과 6초 클립은 동일한 가격입니다. 이 모델을 사용하는 데 월정액 구독이 필요 없습니다.

무료 체험 크레딧으로 처음 몇 개의 클립을 생성해볼 수 있습니다. 더 많은 볼륨이 필요하면 대시보드에서 일반 크레딧을 충전하세요.

Gemini Omni Flash를 사용할 때

다음과 같은 경우에 적합합니다:

• 짧은 제품 또는 컨셉 데모 — 6초 클립은 랜딩 페이지와 광고에 효과적
• 프로토타이핑 — $0.17/클립으로 프리미엄 모델에 투자하지 않고 프롬프트를 반복 시도 가능
• 세로 소셜 콘텐츠 — 9:16 모드는 별도 크롭 없이 Reels과 Shorts에 바로 사용 가능
• 배치 파이프라인 — 고정 요금으로 자동화 워크플로우의 비용 예측이 간단

더 긴 클립이나 오디오가 필요한 경우 Hypereal의 Veo 3.1 엔드포인트를 확인하세요. Gemini Omni Flash의 강점은 대량으로 빠르고 저렴한 720P 클립을 생성하는 것입니다.