hiapi API로 gemini-omni-1.1-flash를 사용해 숏폼 비디오 제작하기

숏폼 비디오에는 단 하나의 무자비한 요구 사항이 있습니다. 반드시 세로형이어야 하고, 1초 안에 사용자를 사로잡아야 하며, 보통 소리도 필요합니다. 대부분의 텍스트-투-비디오 API는 단계를 직접 조립해야 합니다. 먼저 클립을 생성하고, 후반 작업에서 오디오를 추가한 다음, 9:16으로 다시 크롭합니다. gemini-omni-1.1-flash는 이를 hiapi의 단일 비동기 호출로 압축합니다. 프롬프트 하나를 입력하면 주변음이 이미 오디오 트랙에 포함된 완성된 9:16 비디오가 출력됩니다.

이 가이드는 실제 비디오(본문용으로 생성된 것이며 도식이 아님)를 바탕으로 전체 워크플로를 보여 준 뒤, 가격을 깊이 분석합니다. gemini-omni의 비용 모델은 상당히 독특해서 렌더링 방식을 바꿔야 하기 때문입니다.

비디오, 시작부터 완성까지

다음은 모델이 단일 프롬프트로 생성한 8초 1080p 비디오입니다. 인라인으로 바로 재생되며, 세로형이고 소리가 포함되어 있습니다:

다음은 전체 프롬프트입니다. 그대로 복사해 실행하면 됩니다:

Vertical 9:16 cinematic food close-up: a slow ribbon of golden honey drizzles
onto a short stack of warm pancakes, catching soft morning window light as it
pools and slides down the sides. A single pat of butter melts at the top, faint
steam rising. Shallow depth of field, gentle slow push-in, one continuous shot,
warm cozy color grade. Natural ambient sound: the soft drizzle of honey, a quiet
kitchen room tone, distant birdsong. No people, no text, no logos, no watermark.

그 한 번의 요청은 스테레오 AAC 오디오 트랙이 포함된 1080×1920 H.264 파일을 반환했습니다. 주변음은 사후에 덧입힌 것이 아니라 비디오와 함께 생성되었습니다. 두 가지 프롬프트 습관이 대부분의 작업을 해냈습니다:

• 연속된 한 컷을 요구하세요. 숏폼 클립은 하나의 단일 비트처럼 읽힙니다. 중단 없는 카메라 무빙을 요구하면 모델이 원치 않는 편집 지점을 스스로 만들어 내는 것을 막을 수 있습니다.
• 명확한 네거티브 제약 한 줄을 쓰세요. No people, no text, no logos, no watermark는 화면을 깔끔하게 유지해 편집기에서 자막을 추가하기 쉽게 하고, 나중에 제거할 수 없는 번인 텍스트를 방지합니다.

숏폼 비디오에 특히 잘 맞는 이유

세로형 비디오의 실제 요구와 높은 일치도를 보이는 세 가지가 있습니다:

• 네이티브 세로형. aspect_ratio: "9:16"은 일급 입력 파라미터이므로, 16:9 렌더링 결과를 검은 여백이 있는 화면으로 크롭하는 대신 세로형을 바로 생성할 수 있습니다.
• 오디오 내장. 모든 비디오에 주변음이 포함됩니다. 대부분의 스와이프가 무음으로 시작되는 피드에서, 실제로 소리를 켠 시청자를 위해 진짜 오디오 트랙을 준비해 둘 수 있습니다. 별도의 음악이나 효과음 단계가 필요 없어 제작 단계 하나를 줄여 줍니다.
• 하나의 ID, 모든 모드. 동일한 gemini-omni-1.1-flash ID는 참조 이미지, 첫/마지막 프레임 또는 소스 비디오도 받습니다. 텍스트 훅으로 시작한 뒤, 완전히 같은 엔드포인트와 키로 제품 스틸 이미지나 러프 컷을 밀어 넣을 수 있습니다.

렌더링 방식을 바꿔야 할 정액제 알고리즘

대부분의 비디오 API는 초 단위로 과금하고 해상도가 높아질수록 요금도 올라가므로, 1080p는 480p보다 확실히 비쌉니다. gemini-omni는 다릅니다. 비디오 한 편당 정액 가격으로 과금하며, 최대 1080p까지 모든 해상도에서 가격이 완전히 같습니다. 오직 비디오 길이만 가격을 바꿉니다:

비디오 길이	360p / 720p / 1080p	4K
4초	$0.45	$1.05
6초	$0.60	$1.20
8초	$0.75	$1.35
10초	$0.90	$1.50

가격은 hiapi 실시간 가격 페이지에서 2026년 10월 기준으로 확인했습니다. 참조 비디오를 전달하면 길이와 관계없이 과금이 비디오 한 편당 고정 $1.20(최대 1080p, 4K의 경우 $1.80)으로 전환됩니다.

실질적인 결과는 다음과 같습니다: 모든 초안을 1080p로 렌더링하세요. 이 모델에서는 1080p 비용이 360p와 완전히 같으므로, 저해상도로 미리 본 뒤 다시 렌더링할 이유가 없습니다. 4K가 아닌 비디오에서는 청구서에 영향을 주는 유일한 변수가 길이입니다. 따라서 규율은 화질이 아니라 길이에 있습니다. 편당 $0.75로 8초 1080p 초안을 대량 생성하고, 잘 나온 것만 남기고, 실제로 게시할 핵심 완성본에만 4K를 사용하세요.

한 번의 API 호출

비디오 생성은 먼저 POST로 작업을 시작한 후 완료될 때까지 폴링하는 방식입니다.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-1.1-flash",
    "input": {
      "prompt": "<your prompt>",
      "duration": 8,
      "resolution": "1080p",
      "aspect_ratio": "9:16"
    }
  }'

작업 ID를 받게 됩니다:

{"code":200,"data":{"taskId":"tk-hiapi-01M4MJDW91CEF46R26CJJ5NK5N"},"message":"success"}

그런 다음 GET /v1/tasks/<taskId>를 status가 handling → archiving → success로 바뀔 때까지 폴링합니다. 완료된 응답 본문은 비디오를 output[0].url에 담아 반환합니다:

import time, requests

API = "https://api.hiapi.ai/v1"
H = {"Authorization": "Bearer sk-<your-key>", "Content-Type": "application/json"}

def make_clip(prompt, duration=8, resolution="1080p", ratio="9:16"):
    body = {"model": "gemini-omni-1.1-flash",
            "input": {"prompt": prompt, "duration": duration,
                      "resolution": resolution, "aspect_ratio": ratio}}
    tid = requests.post(f"{API}/tasks", headers=H, json=body, timeout=30).json()["data"]["taskId"]
    while True:
        data = requests.get(f"{API}/tasks/{tid}", headers=H, timeout=30).json()["data"]
        if data["status"] == "success":
            return data["output"][0]["url"]
        if data["status"] == "fail":
            raise RuntimeError(data.get("error"))
        time.sleep(6)

url = make_clip("<your prompt>")
open("clip.mp4", "wb").write(requests.get(url, timeout=120).content)

네 가지 입력 필드가 핵심입니다: prompt, duration(4, 6, 8 또는 10), resolution(360p, 720p, 1080p 또는 4k), 그리고 aspect_ratio(16:9 또는 9:16). 이 범위를 벗어난 값을 전달하면 API가 대기열에 넣기 전에 요청을 거부합니다. 예를 들어 실수로 2160p를 쓰면 invalid input: resolution: value must be one of '360p', '720p', '1080p', '4k'가 반환되므로, 오타로 비디오 생성 기회를 낭비하는 일은 결코 없습니다. 전체 작업 API 참고 자료는 hiapi 문서에서 확인하세요.

코드에서 처리할 만한 주의 사항 하나: output[0].url에는 expireAt 타임스탬프가 있으며 영구 링크가 아닙니다. 작업이 success를 보고하는 순간 파일을 다운로드하거나 자체 스토리지로 푸시하세요. 임시 URL을 영속화하지 마세요.

단일 비디오가 아닌 세트를 일괄 제작하기

숏폼 비디오는 물량 게임이므로 실제 워크플로는 배치 처리입니다. 각 비디오는 독립된 작업이므로 실행 중간에 중단되어도 복구 비용이 낮습니다. 각 작업의 키로 프롬프트 해시를 사용하고 이미 다운로드한 것은 건너뛰면, 재시작해도 이중 과금이 발생하지 않습니다.

실행 가능한 루프:

• 하나의 테마를 중심으로 8–12개의 프롬프트 변형을 작성하세요. 서로 다른 각도, 조명, 피사체를 사용하며 모두 8초 / 1080p / 9:16을 적용합니다.
• 독립 작업으로 일괄 제출하고 폴링하거나, 콜백을 등록해 결과가 먼저 도착하게 하세요.
• 전체 세트를 검토하고 실제로 매력적인 두세 개만 남긴 뒤, 필요에 따라 4K 또는 더 긴 길이로 다시 렌더링하세요. 단, 게시하는 플랫폼이 그에 상응하는 보상을 줄 때만 그렇게 하세요.

스틸 이미지나 러프 컷이 진짜 출발점일 때는 동일한 gemini-omni-1.1-flash ID에 입력하세요. 참조 이미지로 제품 외형을 고정하고, 첫/마지막 프레임으로 전환을 제어하거나, 소스 비디오로 스타일을 다시 그릴 수 있습니다. 키와 폴링 코드는 그대로이고 input 객체만 바뀝니다.

비교

gemini-omni의 정액 요금은 오디오가 포함된 숏폼 비디오를 가장 저렴하게 출력하는 방법입니다. 1080p 8초에 $0.75만 들고 초 단위 배수가 없습니다. 다른 모델은 특정 측면에서 더 우수합니다:

• Seedance 2.5는 초 단위로 과금하고 현재 최대 720p이지만, 단일 컷으로 최대 30초까지 확장됩니다. 길이가 해상도보다 중요할 때의 선택입니다.
• Kling 3.0은 주변음 위에 동기화된 음성을叠加하며 4K까지 가능합니다. 말하는 콘텐츠나 립싱크 콘텐츠에 더 적합합니다.
• Veo 3.1은 텍스트에서 생성하는 대신 기존 스틸 이미지를 애니메이션화해야 할 때 이미지-투-비디오 선택입니다.

네 가지 모두 동일한 hiapi 키와 동일한 /v1/tasks 엔드포인트에서 실행되므로, 전환은 model 한 줄만 바꾸면 됩니다. 프로젝트 단위가 아니라 샷 단위로 선택하세요. 모델 카탈로그에서 나란히 살펴볼 수 있습니다.

자주 묻는 질문

gemini-omni-1.1-flash에는 정말 오디오가 포함되나요? 예. 이 가이드의 비디오는 실제 스테레오 오디오 트랙이 포함된 MP4를 반환했습니다. 주변음은 후처리가 아니라 비디오와 함께 생성됩니다. 위의 Natural ambient sound: ... 줄처럼 프롬프트에서 소리를 설명하는 방식은 화면을 설명하는 방식과 같습니다.

가장 저렴하게 테스트하는 방법은 무엇인가요? 4초 비디오는 최대 1080p까지 모든 해상도에서 $0.45입니다. 세 해상도의 가격이 같으므로 1080p로 테스트하세요. 더 낮은 해상도로 미리 볼 가격상의 이유는 없습니다.

가로형 비디오도 만들 수 있나요? 예. aspect_ratio: "16:9"로 설정하면 가로형이고, 9:16이 숏폼 기본값입니다. 두 방식 모두 가격이 같습니다.

비디오는 최대 얼마나 길게 만들 수 있나요? 생성 시마다 4, 6, 8 또는 10초입니다. 더 긴 편집이 필요하면 여러 비디오를 생성해 이어 붙이거나, 참조/첫·마지막 프레임 처리를 사용해 편집 지점 사이의 연속성을 유지하세요.

출력 URL은 영구적인가요? 아니요. output[0].url에는 expireAt이 있어 일회성 전달로 간주해야 합니다. 작업이 success를 보고한 직후 다운로드하거나 다시 호스팅하세요.

시도해 볼 준비가 되셨나요? hiapi 콘솔에서 키를 받고, 위 curl 호출에 자신만의 프롬프트를 넣고, 1080p로 첫 세로형 비디오를 렌더링하세요. 작은 해상도로 미리 보든 바로 전체 해상도로 가든 비용은 똑같이 $0.75입니다.