사용 가이드
AI 이미지 및 비디오 API 비용 관리: 티어, 배치 처리, 모델 선택
동일한 작업에서 가장 저렴한 모델과 가장 비싼 모델의 차이는 34~50배입니다. 비용 관리의 핵심은 각 티어가 언제 가치 있는지 아는 것입니다.
단 한 번의 극적인 API 호출로 AI 미디어 예산이 소진되는 사람은 없습니다. 지출은 세 가지 습관을 통해 조용히 새어 나갑니다: 일회성 초안에 높은 비용을 지불하고, 실제로 어떤 단위로 과금되는지 모르며, 비싼 모델에서 직렬로 반복하는 것—워크플로가 저렴하게 넓게 변형을 생성하도록 설정된 적이 없기 때문입니다.
이 가이드는 hiapi를 통해 이미지와 비디오를 생성할 때 실제로 중요한 비용 레버를 정리합니다: 과금 단위, 품질 티어, 비디오 길이, 초안 후 업그레이드 워크플로, 그리고 비동기 작업 API를 통한 배치 처리. 아래의 모든 가격은 2026년 7월 라이브 가격 페이지에서 가져온 것입니다—스냅샷으로 간주하고 예산을 잡기 전에 현재 가격 확인하세요.
무엇으로 과금되는지 정확히 파악하기
hiapi는 미디어 모델에 대해 고정된 출력 단위당 요금을 부과합니다—역산할 토큰 계산은 없습니다:
- 이미지 모델은 프롬프트가 아무리 복잡해도 이미지당 과금됩니다.
- 비디오 모델은 생성된 출력의 초당 과금됩니다.
- 오디오 모델(예:
elevenlabs/text-to-dialogue-v3)은 입력 텍스트 1,000자당 과금됩니다.
다음은 텍스트-이미지 라인업의 이미지당 가격 개요입니다:
| 모델 | 이미지당 가격 |
|---|---|
flux-schnell/text-to-image |
$0.005 |
gpt-image-2/text-to-image@ext |
$0.007 |
z-image |
$0.008 |
gpt-image-2/text-to-image@beta |
$0.02 |
qwen-image-2.0 |
$0.025 |
gpt-image-2/text-to-image |
$0.03 |
nano-banana |
$0.05 |
flux-1.1-pro |
$0.05 |
flux-2/text-to-image |
$0.05 |
nano-banana-2 |
$0.051 |
wan2.7-image/text-to-image |
$0.08 |
nano-banana-pro |
$0.17 |
그리고 비디오의 초당 가격입니다:
| 모델 | 초당 가격 |
|---|---|
grok-imagine(텍스트-비디오 / 이미지-비디오) |
$0.0114 |
kling-3.0-omni(텍스트-비디오 / 이미지-비디오) |
$0.129 |
seedance-2.0 |
$0.136 |
seedance-2.0-mini |
$0.147 |
wan2.7-video@pro(텍스트-비디오 / 이미지-비디오) |
$0.167 |
happyhorse-1.0 |
$0.168 |
happyhorse-1.1(모든 엔드포인트) |
$0.21 |
seedance-2.0-fast |
$0.2357 |
veo-3.1-fast |
$0.25 |
veo-3.1 |
$0.57 |
기억할 만한 두 숫자: 이미지 라인업은 가장 저렴한 것에서 가장 비싼 것까지 34배($0.005 → $0.17) 차이가 나고, 비디오는 50배(초당 $0.0114 → $0.57) 차이가 납니다. 모델 선택은 조정 노브가 아니라 당신이 내리는 가장 큰 단일 예산 결정입니다.
한 가지 주의: 모델 이름으로 가격을 추론하지 마세요. Veo 패밀리에서 -fast 변형은 더 저렴한 티어($0.25/s 대 $0.57/s)이지만, seedance-2.0-fast는 프리미엄 가속 티어로 기본 seedance-2.0보다 초당 비용이 더 높습니다($0.2357 대 $0.136). 가격표를 읽으세요; 절대 가정하지 마세요.

가격 티어를 세부 사항이 아닌 기능으로 보기
대부분의 모델 패밀리는 티어로 출시되며, 티어의 존재 이유는 모든 작업에 플래그십 가격을 지불하지 않게 하기 위함입니다:
- 초안 티어($0.005–$0.008):
flux-schnell,z-image, 그리고 gpt-image-2의@ext채널. 프롬프트 반복, 구도 테스트, 그리고 사람이 한 번 보고 버릴 모든 것에 사용하세요. - 표준 티어($0.02–$0.05):
gpt-image-2/text-to-image,qwen-image-2.0,nano-banana,flux-2. 블로그 커버, 제품 이미지, UI 자산의 프로덕션 품질에 사용하세요. - 프리미엄 티어($0.08–$0.17):
wan2.7-image와nano-banana-pro. 세부 묘사와 지시 준수가 결정적인 최종 키 비주얼 자산에만 남겨두세요.
같은 논리가 채널 변형에도 적용됩니다: 가격 페이지는 gpt-image-2/text-to-image의 @beta와 @ext 버전을 각각 $0.02와 $0.007로, 표준 채널은 $0.03으로 표시합니다. 워크로드가 프리뷰 채널 약관을 감당할 수 있다면 동일한 프롬프트에서 20%~77%를 절약할 수 있습니다. 이미지당 비용과 해상도 및 재시도율의 상호작용은 가장 저렴한 이미지 생성 API: 이미지당 실제 비용 비교 방법에서 더 깊이 다룹니다.
비디오에서는 길이가 배수입니다
비디오 비용은 요율 × 초입니다. 즉, 의심하지 않은 모든 기본값이 증폭된다는 뜻입니다. 동일한 8초 클립의 비용은:
| 모델 | 8초 클립 |
|---|---|
grok-imagine/text-to-video |
$0.09 |
kling-3.0-omni/text-to-video |
$1.03 |
veo-3.1-fast/text-to-video |
$2.00 |
veo-3.1/text-to-video |
$4.56 |
여기서 직접 도출되는 두 가지 습관:
- 샷을 충족하는 가장 짧은 길이를 요청하세요. veo-3.1 클립을 8초에서 5초로 줄이면 $1.71을 절약합니다—클립마다, 매번.
- 저렴한 모델에서 반복하고, 비싼 모델에서 렌더링하세요.
grok-imagine에서 4초 초안을 6회 반복하는 총 비용은 약 $0.27입니다—veo-3.1로 0.5초를 출력하는 비용보다 적습니다. 거기서 프롬프트 실험을 소진하고, 단 한 번만 $4.56을 지불하세요.
저렴한 초안, 프리미엄 최종본
가장 임팩트 큰 단일 워크플로 변화는 탐색과 납품을 분리하는 것입니다. 제품 이미지의 실제 예시:
z-image에서 20회 초안 반복, 회당 $0.008 = $0.16nano-banana-pro에서 3회 최종 렌더링, 회당 $0.17 = $0.51- 합계: $0.67
23회 생성 모두를 nano-banana-pro에서 실행하면 $3.91이 듭니다. 동일한 수의 API 호출, 동일한 최종 자산, 약 83% 적은 지출—게다가 초안 루프가 더 빠릅니다. 초안 티어 모델은 몇 초 만에 반환되기 때문입니다.
유일한 주의점: 프롬프트가 서로 다른 패밀리 간에 완벽히 이전되지 않습니다. 마지막 한두 번의 반복에서는 초안 루프를 최종 확정에 사용할 모델에서 유지하세요. 그래야 프리미엄 예산을 투입하기 전에 패밀리 특유의 특성을 발견할 수 있습니다.

비동기 작업 API를 통한 배치 처리
hiapi의 모든 미디어 모델은 비동기 작업 엔드포인트를 통해 실행됩니다: POST /v1/tasks가 즉시 작업 ID를 반환하면, 결과를 폴링합니다. 배치 처리에 요청당 할인은 없습니다—이점은 구조적입니다. 제출과 완료가 분리되어 있으므로, 각 생성을 직렬로 기다리는 대신 전체 초안 배치를 한 번에 분산할 수 있습니다. 이것이 바로 초안 후 업그레이드 루프를 실용적으로 만드는 이유입니다:
import requests, time
API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
def create_task(model: str, prompt: str) -> str:
r = requests.post(API, headers=HEADERS, json={
"model": model,
"input": {"prompt": prompt, "aspect_ratio": "1:1"},
})
r.raise_for_status()
return r.json()["data"]["taskId"]
def wait_task(task_id: str, timeout: int = 600) -> str:
deadline = time.time() + timeout
while time.time() < deadline:
task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
if task["status"] == "success":
return task["output"][0]["url"] # expiring URL — download it now
if task["status"] == "fail":
raise RuntimeError(task.get("error"))
time.sleep(5)
raise TimeoutError(task_id)
# Fan out 12 draft variations on a $0.008 model: ~$0.10 for the whole batch
variations = [f"studio product shot of a ceramic mug, camera angle {i}" for i in range(12)]
task_ids = [create_task("z-image", p) for p in variations]
urls = [wait_task(t) for t in task_ids]
열두 개를 모두 먼저 제출한 다음 폴링하세요—작업은 플랫폼 측에서 동시에 생성되고, 코드는 한 번만 기다립니다. prompt 외의 입력 필드는 모델마다 다릅니다(일부는 resolution을 받고, 일부는 aspect_ratio만 받음). 따라서 배치 처리 전에 모델의 매개변수 표를 확인하세요. gpt-image-2 워크스루가 이 패턴을 엔드투엔드로 보여줍니다.
분산 규모를 확장할 때는 플랫폼의 동시성 한도를 준수하세요—429를 유발하는 버스트는 재시도 지연만 늘립니다. 이미지 생성 API 속도 제한 자세히 보기에서 제한이 어떻게 동작하고 어떻게 깔끔하게 백오프할 수 있는지 다룹니다.
열 줄짜리 예산 가드는 "지출을 주시하겠다"를 진짜 불변 조건으로 바꿔줍니다:
PRICES = {"z-image": 0.008, "gpt-image-2/text-to-image": 0.03, "nano-banana-pro": 0.17}
BUDGET_USD = 5.00
spent = 0.0
def spend(model: str, images: int = 1) -> None:
global spent
cost = PRICES[model] * images
if spent + cost > BUDGET_USD:
raise RuntimeError(f"budget cap: ${spent + cost:.2f} would exceed ${BUDGET_USD:.2f}")
spent += cost
각 create_task 전에 호출하면, 통제를 벗어난 루프가 다음 달 청구서가 아니라 $5에서 큰 소리로 실패합니다.
같은 출력에 두 번 지불하지 마세요
더 교묘한 비용 누수는 재생성입니다—이미 가진 출력에 정가를 지불하는 것:
- 결과를 즉시 다운로드하세요. 작업 출력 URL에는 시간 제한이 있습니다. 파일 대신 핫링크를 저장했는데 링크가 만료되면, 유일한 해결책은 비용을 지불하고 재생성하는 것입니다. 자세한 내용과 다운로드 패턴은 여기서 확인하세요.
- "작업 실패"와 "내 폴링이 포기함"을 구분하세요. 클라이언트 타임아웃 후에야 성공한 작업은 아무도 수집하지 않은 출력에 쓴 돈입니다. 폴링 타임아웃을 모델의 실제 완료 시간보다 훨씬 길게 설정하세요—실패로 단정하기 전에 이곳에서 중단된 작업을 진단하는 방법을 확인하세요.
- 자신의 라이브러리를 재사용하세요. 다섯 번째 "흰색 배경의 깔끔한 스튜디오 사진"을 생성하기 전에 이미 지불한 자산을 확인하세요. 검색 가능한 프롬프트가 있는 공유 버킷은 당신의 스택에서 가장 저렴한 모델입니다.
비용 관리 체크리스트
- 모델의 기본 단위로 예산을 잡으세요: 이미지당, 초당, 1,000자당.
- 미디어 유형별로 초안 티어와 납품 티어 모델을 하나씩 선택하세요; 작업 단계에 따라 라우팅하세요.
- 비디오의 경우 모든 길이 기본값을 의심하세요—초는 배수입니다.
/v1/tasks를 통해 초안을 분산하세요; 승자만 프리미엄 렌더링으로 승격하세요.- 매주 확인하는 대시보드가 아니라 코드에서 하드 지출 한도를 강제하세요.
- 모든 출력을 즉시 다운로드하세요; 만료되는 URL을 저장하지 마세요.
모델 가격은 새 버전이 출시되면서 변하므로, 라이브 가격 페이지에서 시작하고 모델 카탈로그에서 초안 티어와 납품 티어를 선택한 뒤 위의 분산 패턴을 파이프라인에 연결하세요—처음 실행하는 작업 배치가 사용 가능한 모든 자산의 실제 비용을 정확히 알려줄 것입니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트