영상 초당 과금
요청한 클립 길이에 비례해 과금됩니다. 720p는 초당 29크레딧($0.29), 1080p는 초당 49크레딧($0.49)이며 오디오가 포함됩니다. 5초 720p 클립은 145크레딧($1.45), 10초 1080p 클립은 490크레딧($4.90)입니다.
Video 제공: Black Forest Labs
Flux 3 API
Black Forest Labs의 첫 비디오 모델을 하나의 통합 API로. 프롬프트, 최대 10장의 이미지, 이어서 생성할 클립에서 동기화된 오디오와 함께 720p 또는 1080p 영상을 최대 20초까지 생성합니다. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 지원합니다.
Flux 3을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.
model: "flux-3" Flux 3의 특별한 점
같은 과정에서 오디오까지
배경음, 대사, 효과음이 영상과 함께 생성되어 동기화되며 추가 비용이 없습니다. 무음 클립이 필요하면 플래그 하나로 끌 수 있습니다.
한 번의 생성으로 최대 20초
5~20초 사이의 정수 초를 지정하거나, 생략하면 콘텐츠에 맞는 길이를 모델이 선택합니다.
최대 10장 이미지로 스토리보드
한 장은 첫 프레임으로 픽셀 그대로 사용되고, 두 장은 시작과 끝 프레임을 지정하며, 세 장 이상은 타임라인에 균등하게 배치되는 키프레임이 됩니다.
샷을 이어서 연결
완성된 mp4를 start_video로 전달하면 마지막 프레임부터 이어서 생성합니다. 연결하면 한 번에 20초라는 제한을 넘는 시퀀스를 만들 수 있습니다.
반복 작업엔 저렴한 드래프트
드래프트 모드는 초당 10크레딧($0.10)으로 빠른 720p 미리보기를 반환합니다. 최종 품질 요금의 약 3분의 1 수준이라, 최종 품질에 비용을 쓰기 전에 프롬프트를 검증할 수 있습니다.
Flux 3(으)로 시도해 볼 프롬프트
Apiframe의 Flux 3 API로 실행할 수 있는 프롬프트 예시입니다.
새벽에 등대지기가 나선 계단을 오른다. 아래에서 파도가 부서지고 바람과 갈매기 소리가 들린다
따뜻한 램프 아래에서 노점 상인이 국수를 담는다. 김이 올라오고 지글거리는 소리와 사람들의 대화 소리
텅 빈 극장을 천천히 달리 촬영. 객석 조명이 켜지고 빛줄기 속에 먼지가 떠다니며 멀리서 오케스트라가 음을 맞춘다
소나무 숲 위로 상승해 낮은 구름 속으로 들어가는 항공 촬영. 바람 소리가 점점 커진다
개요
- 엔드포인트
- POST /v2/videos/generate
- 모델 ID
- flux-3
- 파라미터 키
- flux3Params
- 모달리티
- 비디오
- 제공업체
- Black Forest Labs
- 평균 완료 시간
- ~240s
기능
화면 비율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초
이미지 입력지원
오디오지원
평균 시간~240초
빠른 시작
API 키와 함께 POST /v2/videos/generate 요청을 한 번 보내면 Flux 3로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.
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
}
}'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" }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);응답 및 작업 수명 주기
생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.
1. 제출 응답 (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. 결과 폴링
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"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"])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);입력 스키마
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 | 선택 | "720p" | "720p", "1080p" | Resolution |
| flux3Params.generate_audio | boolean | 선택 | true | — | Synchronized ambient sound, speech, and effects. On by default. |
| flux3Params.draft | boolean | 선택 | false | — | Fast, low-cost 720p preview for iterating on a prompt. |
자주 묻는 질문
Flux 3 API에 대한 일반적인 질문입니다.
Flux 3 영상은 얼마나 길게 만들 수 있나요?
한 번의 생성으로 5~20초 사이의 정수 초입니다. duration을 생략하면 프롬프트에 맞는 길이를 모델이 선택하며, 이 경우 최대치인 20초 기준으로 과금되므로 정확한 요금을 원하면 duration을 명시하세요. 더 길게 만들려면 완성된 클립을 start_video로 전달해 생성을 이어 붙이세요.
Apiframe에서 Flux 3 요금은 어떻게 되나요?
영상 초당 과금입니다. 720p는 초당 29크레딧($0.29), 1080p는 초당 49크레딧($0.49)이며 오디오가 포함됩니다. 드래프트 미리보기는 초당 10크레딧($0.10)입니다. 기존 영상을 이어서 생성하면 720p는 초당 70크레딧($0.70), 1080p는 초당 90크레딧($0.90)입니다. 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로 두면 프롬프트와 입력을 보고 모델이 선택합니다.
아직 궁금한 점이 있으신가요?
Flux 3 API로 개발을 시작하세요
API 키를 받아 몇 분 만에 Flux 3을(를) 통합하세요 — 사용한 만큼 지불.
무료 크레딧으로 시작
모든 모델을 위한 하나의 API
웹훅, SDK 및 멱등성
제공업체 계정 불필요
궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.