FLUX.3 비디오 API 사용법? 텍스트 생성, 이미지 생성, 비디오 이어 만들기 중국어 튜토리얼

TL;DR

• FLUX.3 Video는 Black Forest Labs의 비디오 모델로, HiAPI에서는 모델명이 flux-3 하나뿐이며 텍스트→비디오, 이미지→비디오(1–10장 키프레임), 비디오 이어 만들기를 동시에 지원하고, 1개당 5–20초, 기본적으로 동기화된 사운드가 포함됩니다. 모델 페이지 열기에서 바로 온라인 생성할 수 있고, 신규 사용자 가입 시 200 크레딧을 드립니다.
• 초 단위 과금: 720p 초당 $0.25, 1080p 초당 $0.42; Draft 미리보기 모드는 초당 단 $0.09. 5초 Draft 미리보기는 $0.45.
• 프롬프트를 조정할 때는 반드시 draft: true를 먼저 켜세요: prompt 하나만 필수 항목이라, 다른 파라미터를 쓰지 않아도 정식 요금제로 과금됩니다.

먼저 결과 보기

모델 페이지 예시, 720p, 5초, 사운드 포함:

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

이 프롬프트로 생성하기 →(5초, 720p)

flux-3 모델 페이지 예시, 720p, 5초, 사운드 포함. 정식 요금제 기준 $1.25, Draft 미리보기는 $0.45.

가격

모드	720p / 초	1080p / 초
정식 생성(텍스트, 이미지)	$0.25	$0.42
Draft 미리보기	$0.09	지원 안 함
비디오 이어 만들기(start_video 전달)	$0.59	$0.76
Draft + 비디오 이어 만들기	$0.18	지원 안 함

HiAPI 현재 가격, 2026년 10월 15일 확인. 사운드 켜짐 여부는 가격에 영향 없음.

길이	Draft 720p	정식 720p	정식 1080p
5초	$0.45	$1.25	$2.10
10초	$0.90	$2.50	$4.20
20초	$1.80	$5.00	$8.40

권장 흐름: Draft로 프롬프트와 동작을 맞춘 뒤(1개당 $0.45부터), 확정되면 정식 요금제로 720p 또는 1080p를 출력하세요.

curl: 먼저 Draft 한 개 실행하기

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

5초 Draft, $0.45. taskId가 반환되면 결과 조회:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

status가 success가 되면 output[0].url에서 비디오를 다운로드하세요. 사운드는 이미 같은 MP4에 합쳐져 있습니다.

Python: 제출, 폴링, 다운로드

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 定稿后出正式 1080p
url = generate(
    prompt="一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

이 8초 1080p는 $3.36입니다.

이미지→비디오: 첫 프레임 1장, 또는 최대 10장 키프레임

input에 images를 추가하세요(image_urls가 아님). 장수에 따라 사용법이 결정됩니다:

• 1장: 첫 프레임.
• 2장: 첫 프레임 + 마지막 프레임, 모델이 중간 전환을 채웁니다.
• 3–10장: 키프레임 스토리보드, 영상 전체에 균등하게 배치됩니다.

{
  "model": "flux-3",
  "input": {
    "prompt": "从日出平滑过渡到霓虹闪烁的夜晚城市，镜头稳定",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

이미지는 PNG, JPEG, WebP를 지원합니다. 이미지→비디오와 텍스트→비디오는 같은 가격입니다.

비디오 이어 만들기: 기존 비디오에 이어서 촬영하기

start_video를 전달하면 모델이 이 비디오의 끝에서부터 이어서 생성합니다:

{
  "model": "flux-3",
  "input": {
    "prompt": "镜头继续向前推进，列车驶入明亮的山间隧道",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video는 MP4만 지원하며, 최대 15초, 최대 50 MB입니다.
• images와 start_video는 동시에 전달할 수 없습니다.
• 이어 만들기 단가는 더 높습니다: 720p 초당 $0.59, Draft 이어 만들기 초당 $0.18.

파라미터 한눈에 보기

파라미터	값	설명
prompt	문자열, 필수	장면, 동작, 카메라 무빙, 대사와 사운드를 모두 여기에 작성
duration	5–20 정수, 기본 5	단위 초
resolution	720p / 1080p, 기본 720p	Draft는 720p만 가능, Draft에 1080p를 지정하면 거부됨
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, 기본 auto
draft	기본 false	저가 미리보기 모드
generate_audio	기본 true	끄면 무음 비디오 출력, 가격은 동일
images	최대 10장	이미지→비디오
start_video	MP4 주소	비디오 이어 만들기

출시 전 주의사항

• 폴링 대신 콜백 사용: 요청 최상위(input과 같은 레벨)에 "callback": {"url": "https://你的域名/hiapi/callback"}를 추가하고, taskId로 중복을 제거하세요.
• 즉시 저장: output[0].url은 임시 링크이므로 받은 즉시 자신의 스토리지에 저장하세요.
• 재시도 시 멱등 키 사용: 요청 헤더에 Idempotency-Key를 추가하면 같은 키로 재시도해도 작업이 한 번만 생성되어 중복 과금되지 않습니다.
• 실패 시 자동 환불: 성공적으로 생성된 비디오만 과금됩니다.

자주 묻는 질문

한 개는 최대 얼마나 길 수 있나요?

20초입니다. 더 길게 하려면 비디오 이어 만들기로 계속 생성하세요.

사운드를 끌 수 있나요? 끄면 저렴해지나요?

네, generate_audio: false입니다. 가격은 해상도, Draft, 이어 만들기 여부만 보며, 사운드를 꺼도 저렴해지지 않습니다.

Draft와 정식 요금제는 얼마나 차이 나나요?

720p 초당 $0.09 대 $0.25로, Draft가 약 64% 저렴하고 생성도 더 빨라 프롬프트 조정에 적합합니다.

모델명에 /text-to-video 접미사가 없는 이유는?

FLUX.3는 텍스트 생성, 이미지 생성, 이어 만들기를 하나의 flux-3에 통합했으며, images, start_video 전달 여부로 구분합니다.

먼저 하나 시험해 보고 싶다면, 모델 페이지에서 생성하기. 더 많은 비디오 모델 가격 비교는 가격 페이지를 참고하세요.