비디오

Flux 3 API

Black Forest Labs의 첫 비디오 모델을 하나의 통합 API로. 프롬프트, 최대 10장의 이미지, 이어서 생성할 클립에서 동기화된 오디오와 함께 720p 또는 1080p 영상을 최대 20초까지 생성합니다. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 지원합니다.

API 키 받기 문서 읽기

1080P
최대 해상도: 20s
최대 클립 길이: ~165s
평균 생성 시간: 8 credits/s
최저 가격

비디오 · 예시

플레이그라운드

Flux 3, 지금 바로 사용해 보세요.

model: flux-3

프롬프트

화면 비율 길이 Resolution

Generate audio Synchronized ambient sound, speech, and effects. On by default.

미디어 입력

Images Start video

고급 설정

Draft preview Fast, low-cost 720p preview for iterating on a prompt.

예상 비용 64–528 크레딧 · $0.64–$5.28 Studio에서 생성

출력

출력이 여기에 표시됩니다. 생성을 누르면 Studio에서 이 요청이 실행됩니다.

요금

단순한 초당 과금.

8–66 크레딧 / 출력 1초당 ≈ $0.08–$0.66

요금은 선택한 해상도와 옵션에 따라 달라집니다.

12초 클립은 96–792 크레딧(≈ $0.96–$7.92)입니다.

성공한 생성에 대해서만 비용을 지불합니다. 실패한 작업은 자동으로 환불됩니다.
Apiframe의 모든 모델에서 하나의 크레딧 잔액을 사용합니다. 모델별 요금제가 없습니다.
무료 크레딧으로 시작하세요. 구독이 필요 없습니다.
대용량 플랜에는 볼륨 할인이 적용됩니다.

요금제와 크레딧 팩 보기

스펙

한눈에 보기.

공급업체 Black Forest Labs

모델 ID flux-3

화면 비율 auto, 16:9, 21:9, 2:1, 4:3, 1:1, 3:4, 9:16

해상도 720p, 1080p

길이 5초, 6초, 7초, 8초, 9초, 10초, 11초, 12초, 13초, 14초, 15초, 16초, 17초, 18초, 19초, 20초

이미지 입력 지원

오디오 지원

평균 시간 ~165초

빠른 시작

Flux 3 API 호출 방법.

API 키와 함께 POST /v2/videos/generate 요청 하나만 보내세요. 호출은 폴링할 수 있는 jobId를 반환하며, webhook_url을 전달하면 결과가 준비되는 즉시 푸시됩니다.

모델 값 flux-3만 다른 모델로 바꾸면 나머지는 그대로입니다.

API 키 받기 문서 읽기

generate.js

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "flux-3",
    "flux3Params": {
      "images": [
        "https://example.com/input.jpg"
      ],
      "start_video": "https://example.com/input.jpg",
      "resolution": "720p",
      "generate_audio": true
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "flux-3",
        "flux3Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "start_video": "https://example.com/input.jpg",
            "resolution": "720p",
            "generate_audio": True
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "flux-3",
        "flux3Params": {
            "images": [
                "https://example.com/input.jpg"
            ],
            "start_video": "https://example.com/input.jpg",
            "resolution": "720p",
            "generate_audio": true
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

입력 스키마

Flux 3 모델이 받는 모든 필드와 타입, 기본값입니다. 전체 레퍼런스는 문서에 있습니다.

필드	타입	설명
prompt 필수	string	생성할 내용에 대한 텍스트 설명.
model 필수	string	이 엔드포인트의 모델 식별자. 기본값:"flux-3" · "flux-3"
flux3Params.images	string[] (URLs)	None = text-to-video, one opens the clip, two start and end it, three or more become a storyboard (pick a duration).
flux3Params.start_video	string (URL)	Continue a clip from its final frames. Cannot be combined with images.
flux3Params.resolution	string	Resolution 기본값:"720p" · "720p", "1080p"
flux3Params.generate_audio	boolean	Synchronized ambient sound, speech, and effects. On by default. 기본값:true
flux3Params.draft	boolean	Fast, low-cost 720p preview for iterating on a prompt. 기본값:false

Flux 버전

Apiframe의 모든 Flux 비디오 모델. 파라미터 하나로 전환하세요.

Flux 3 플래그십 현재 페이지

Flux 3 관련 질문

Flux 3 도입 전에 팀들이 자주 묻는 질문입니다. 그 외 내용은 문서에 있습니다.

Flux 3 영상은 얼마나 길게 만들 수 있나요?

한 번의 생성으로 5~20초 사이의 정수 초입니다. duration을 생략하면 프롬프트에 맞는 길이를 모델이 선택하며, 이 경우 최대치인 20초 기준으로 과금되므로 정확한 요금을 원하면 duration을 명시하세요. 더 길게 만들려면 완성된 클립을 start_video로 전달해 생성을 이어 붙이세요.

Apiframe에서 Flux 3 요금은 어떻게 되나요?

영상 초당 과금입니다. 720p는 초당 21크레딧($0.21), 1080p는 초당 36크레딧($0.36)이며 오디오가 포함됩니다. 드래프트 미리보기는 초당 8크레딧($0.08)입니다. 기존 영상을 이어서 생성하면 720p는 초당 51크레딧($0.51), 1080p는 초당 66크레딧($0.66)입니다. duration을 생략하면 최대치인 20초 기준으로 과금됩니다.

오디오도 생성되나요?

네. 동기화된 배경음, 대사, 효과음이 영상과 같은 과정에서 생성되며 기본으로 켜져 있고 추가 비용이 없습니다. 무음 클립을 원하면 generate_audio를 false로 설정하세요.

첫 프레임과 마지막 프레임은 어떻게 지정하나요?

flux3Params의 images로 지정합니다. 한 장은 첫 프레임으로 픽셀 그대로 사용되고, 두 장은 시작과 끝을 지정합니다. 세 장 이상(최대 10장)은 클립 전체에 균등 배치되는 스토리보드가 되며, 이 모드에서는 duration을 명시해야 합니다.

이미 생성한 영상을 연장할 수 있나요?

네. 해당 URL을 flux3Params.start_video로 전달하면 마지막 프레임부터 이어서 생성합니다. 입력은 50MB 이하, 15초 이내의 mp4여야 하며 images와 함께 사용할 수 없습니다.

Flux 2와 어떻게 다른가요?

Flux 2는 이미지 모델입니다. Flux 3는 Black Forest Labs의 Self-Flow 아키텍처를 기반으로 이미지, 영상, 오디오를 아우르며 학습된 멀티모달 모델로, 소리가 있는 영상을 출력합니다.

지원하는 해상도와 화면 비율은 무엇인가요?

720p 또는 1080p이며 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16을 지원합니다. 화면 비율을 auto로 두면 프롬프트와 입력을 보고 모델이 선택합니다.