Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale은 원본에 충실한 또는 창의적인 세부 보강으로 기존 클립을 확대합니다. 문서상의 규격은 1.5~3배 확대를 제공하고 원본 오디오와 프레이밍을 보존하며 원본 길이, 입력 해상도, 출력 프레임 면적을 제한합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
FLUX Video Upscale은 Black Forest Labs의 FLUX 3 기반 영상 초해상도 워크플로입니다. 기존 클립을 받아 원본 프레이밍과 오디오를 결과에 이어받은 확대 MP4를 반환합니다. 선택적인 짧은 설명으로 강화되는 시각 세부를 유도할 수 있습니다. 두 모드는 모든 큰 이미지를 똑같이 충실한 복원으로 취급하지 않고 제공된 외형에 가깝게 유지할지 더 적극적으로 세부를 생성할지 의미 있는 선택을 제공합니다.
정밀 또는 창의적 보강 선택
creativity 설정이 모드를 선택합니다. 값 0은 정밀하고 원본에 충실한 규격입니다. 제조사는 얼굴, 제품, 브랜드 자산의 정체성을 유지해야 할 때 권장합니다. 값 1은 창의적인 세부 보강을 활성화하며 기본값입니다. 질감을 더 적극적으로 복원하거나 만들어 낼 수 있어 생성 영상, 풍경, 군중, 세부를 창의적으로 발전시킬 표면에 유용합니다.
제조사는 창의적 보강이 얼굴과 제품을 같은 수준으로 엄격히 보존하지는 않는다고 명시합니다. 얼굴 외형, 제품 윤곽, 글자, 재질 무늬, 로고 등 식별 가능하게 남아야 할 특징을 확인하세요. 더 선명한 시각 결과에도 달라지거나 새로 만들어진 세부가 있을 수 있습니다. 제품 시연에서는 질감이 더 정교하다는 이유만으로 버전을 고르지 말고 의도한 제품 외형을 검토 기준으로 삼으세요.
선택적인 프롬프트는 보강을 유도할 클립 내용을 설명합니다. 설명이 비어 있으면 중립적인 확대를 요청합니다. 원래의 생성 장면 요구사항은 이끼 낀 돌담, 부드러운 낮빛, 섬세한 잎 질감을 지정할 수 있습니다. 문구는 정밀하게 다듬을 자료에 관한 것으로 유지하세요. 물체 교체, 배경 재구축, 대화 변경은 편집 결정에 속하며 이 규격은 원본 오디오 트랙을 유지합니다.
배율과 출력 프레임 면적
문서상의 upscale_factor 범위는 1.5~3이며 기본값은 2입니다. 화면비를 보존하면서 원본 해상도를 확대합니다. 선택한 배율과 입력 크기가 의도한 출력을 결정하므로 가로 클립과 세로 구도는 실제 프레임을 바탕으로 계획해야 합니다. 어느 정도 확대가 유용한지 선택하기 전에 목표 표시 크기를 준비하세요.
정확한 규격은 각 출력 프레임을 제조사 메가픽셀 단위 13.75로 제한합니다. 문서는 한 단위를 1,048,576픽셀로 정의하므로 상한은 14,417,920픽셀, 약 1,440만 픽셀입니다. 이는 안내의 반올림된 14.4메가픽셀 표현을 설명합니다. 따라서 큰 원본은 요청 배율보다 덜 확대될 수 있습니다. 3배 요청이 언제나 원본 각 변을 3배로 만든다고 가정하지 말고 전달된 크기를 확인하세요.
공개 원본 해상도 상한은 2560×1440입니다. 이 워크플로는 적격 원본을 4K 이상으로 확대하지만 높은 출력을 원한다는 이유만으로 이미 더 큰 원본을 받지는 않습니다. 문서상의 규격을 쓰기 전에 축소하거나 적절한 작업용 사본을 준비하세요. 최종 비교가 크기를 바꾼 중간 자료에만 한정되지 않도록 원본 녹화를 별도로 보관하세요.
짧고 판독하기 좋은 원본 준비
제조사의 일반 준비 안내는 원본을 20초와 50 MB로 제한합니다. 클립은 영상 URL 또는 인코딩된 MP4로 제공합니다. 정확한 참조는 첫 20초를 처리한다고 설명합니다. 길이가 조금 넘으면 해당 지점까지만 처리될 수 있지만 상당히 긴 클립은 거절됩니다. 수치적인 허용 오차는 공개되지 않았습니다. 지정되지 않은 경계 동작에 의존하지 말고 의도한 20초 이하 구간으로 자르세요.
가능한 가장 적게 압축된 버전을 선택하세요. 압축 아티팩트는 업스케일러가 복원할 실제 세부의 양을 제한하며 창의적 보강은 원본 장면에 무엇이 있었는지 확립하지 않고도 그럴듯한 질감을 만들 수 있습니다. 선택한 클립을 확대하기 전에 의도한 편집과 자르기를 완료하세요. 예를 들어 제품 숏을 먼저 완성하고 유용한 행동 구간을 선택한 뒤 변경하지 않은 원본을 비교용으로 유지하면서 최종 선택을 확대할 수 있습니다.
결과는 원본 오디오 트랙을 유지합니다. 특히 선택 구간의 시작과 끝에서 화면과의 타이밍을 살피세요. 문서상의 규격은 독립적인 프레임 레이트 선택기, 새 대화 생성, 이미지 참조 편집 제어를 제공하지 않습니다. 목적은 확대 영상과 선택한 세부 처리이며 처리 구간 안의 원본 시간·소리 자료를 유지합니다.
전달된 클립 보관과 검토
제작사 워크플로는 비동기입니다. 제출한 작업은 식별자와 상태 확인 위치를 제공하고 완료 결과에는 서명된 MP4 전달 링크가 포함됩니다. 링크는 약 1시간 후 만료됩니다. 임시 위치에 의존하지 말고 실제 클립, 원본, 선택 배율, creativity 모드, 내용 설명을 보관하세요. 실패나 검토 제한 상태는 완료된 영상과 구분하세요.
개별 프레임에서 얼굴, 표식, 표면 변화를 검토한 뒤 시퀀스를 보며 연속성, 움직임, 오디오 정렬을 확인하세요. 정밀 출력과 창의적 출력은 서로 다른 시각 요구에 답합니다. 유용한 결과물은 의도한 표시 크기에서 선택한 충실도 목표를 충족하는 확대 클립입니다. 해상도가 커졌다는 사실만으로 원래 정체성, 문구, 미세 세부가 정확히 유지되었다는 증거가 되지는 않습니다.
Ailoot Ultra · 동영상 POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale시작하기
FLUX Video Upscale은 원본에 충실한 또는 창의적인 세부 보강으로 기존 클립을 확대합니다. 문서상의 규격은 1.5~3배 확대를 제공하고 원본 오디오와 프레이밍을 보존하며 원본 길이, 입력 해상도, 출력 프레임 면적을 제한합니다.
- 허용 입력
- 텍스트 · 이미지 · 오디오 · 동영상
- 결과
- 동영상
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 동영상 POST /v1/videos
- 입력
text,image,audio,video- 출력
video
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 black-forest-labs/flux-video-upscale | 기본값— |
필드input_references | 유형array | 요건필수 | 값과 한도 최소 항목 수: 1 최대 항목 수: 1 | 기본값— |
필드upscale_factor | 유형number | 요건필수 | 값과 한도 최솟값: 1.5 최댓값: 3 | 기본값— |
필드creativity | 유형integer | 요건필수 | 값과 한도 0, 1 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input_references, upscale_factor, creativity |
매개변수material_types | 명세text, image, audio, video |
매개변수material_conditions | 명세실제로 완료된 소유 동영상 자산의 콘텐츠 URL 하나와 함께 반환된 서명만 사용하세요. 자산 소유자, 유형 및 저장된 바이트 증빙이 요청과 일치해야 합니다. |
수명 주기: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · 실제로 반환된 id 또는 polling_url
GET /v1/videos/{request_id}/content
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 단위 | 과금 조건 | 메가픽셀당 픽셀 수 | 요금 |
|---|---|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 단위— | 과금 조건— | 메가픽셀당 픽셀 수— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위메가픽셀·초당 | 과금 조건품질: creative | 메가픽셀당 픽셀 수1,048,576 | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.21 메가픽셀·초당 |
| 설정동영상 요금 | 요금표— | 예측 수량— | 과금 단위메가픽셀·초당 | 과금 조건quality: precise | 메가픽셀당 픽셀 수1,048,576 | 요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.15 메가픽셀·초당 |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 과금 조건— | 메가픽셀당 픽셀 수— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.15 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 동영상
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
결과 수신 및 저장
Ailoot Ultra · 동영상
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
완료된 자산 모두 저장
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
완료된 결과 모두 보관
완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
X-Client-Request-ID, X-Ailoot-Task-Id 및 실제로 반환된 id/polling_url을 보존하세요. 원래 작업을 계속 진행하고 생성을 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드id | 유형 |
필드status | 유형 |
필드data[] | 유형 |
필드outputs[] | 유형 |
별칭
모델 별칭
Ailoot Ultra black-forest-labs/flux-video-upscale
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Black Forest Labs: FLUX Video Upscale
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- 요청은 어떤 필드를 사용하나요?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- 어떤 제한이 적용되나요?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3