Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale ขยายคลิปเดิมด้วยการเพิ่มรายละเอียดแบบรักษาต้นฉบับหรือเชิงสร้างสรรค์ โปรไฟล์ที่ระบุให้ขยาย 1.5×–3× คงเสียงและกรอบภาพเดิม พร้อมจำกัดความยาวต้นฉบับ ความละเอียดอินพุต และพื้นที่เฟรมเอาต์พุต

Ailoot Ultra · วิดีโอ POST /v1/videos black-forest-labs/flux-video-upscale

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

FLUX Video Upscale เป็นเวิร์กโฟลว์เพิ่มความละเอียดวิดีโอด้วย FLUX 3 ของ Black Forest Labs รับคลิปเดิมและคืน MP4 ที่ขยาย โดยคงกรอบภาพและเสียงต้นฉบับ ใช้คำอธิบายสั้นเพิ่มเติมกำกับรายละเอียดภาพได้ สองโหมดให้เลือกระหว่างการรักษารูปลักษณ์เดิมกับสร้างรายละเอียดมากขึ้น ไม่ใช่ถือว่าภาพใหญ่ทุกภาพฟื้นต้นฉบับได้ตรงกันเท่า ๆ กัน

เลือกเพิ่มรายละเอียดแบบแม่นยำหรือสร้างสรรค์

ค่า creativity เลือกโหมด ค่า 0 คือแบบแม่นยำที่รักษาต้นฉบับ ผู้ผลิตแนะนำเมื่อใบหน้า สินค้า หรือสื่อแบรนด์ต้องคงอัตลักษณ์ ค่า 1 เปิดการเพิ่มรายละเอียดเชิงสร้างสรรค์และเป็นค่าเริ่มต้น ฟื้นหรือสร้างพื้นผิวได้มากกว่า เหมาะกับฟุตเทจที่สร้างขึ้น ทิวทัศน์ ฝูงชน หรือพื้นผิวที่ปรับอย่างสร้างสรรค์ได้

ผู้ผลิตเตือนชัดว่าโหมดสร้างสรรค์รักษาใบหน้าและสินค้าไม่เคร่งครัดเท่า ตรวจสิ่งที่ต้องยังระบุได้ เช่น ใบหน้า โครงร่างสินค้า ตัวอักษร ลายวัสดุ หรือโลโก้ ภาพคมขึ้นอาจมีรายละเอียดเปลี่ยนหรือสร้างใหม่ สำหรับสาธิตสินค้าให้ใช้รูปลักษณ์สินค้าที่ต้องการเป็นเกณฑ์ แทนเลือกเพียงเพราะพื้นผิวละเอียดกว่า

พรอมป์ต์เสริมบรรยายเนื้อหาคลิปเพื่อกำกับการเพิ่มรายละเอียด หากว่างจะขยายแบบเป็นกลาง บรีฟฉากตัวอย่างอาจระบุกำแพงหินมีมอส แสงกลางวันนุ่ม และรายละเอียดใบไม้ เน้นวัสดุที่จะปรับ คำขอเปลี่ยนวัตถุ สร้างสถานที่ใหม่ หรือเปลี่ยนบทสนทนาเป็นการตัดสินใจด้านการแก้ไข ขณะที่โปรไฟล์นี้คงเสียงต้นฉบับ

ตัวคูณและพื้นที่เฟรมเอาต์พุต

upscale_factor ที่ระบุอยู่ระหว่าง 1.5 ถึง 3 ค่าเริ่มต้น 2 ขยายความละเอียดโดยรักษาอัตราส่วน ตัวคูณกับขนาดอินพุตกำหนดเอาต์พุตที่ตั้งใจ จึงต้องวางแผนคลิปแนวนอนและแนวตั้งจากเฟรมจริง เตรียมขนาดแสดงเป้าหมายก่อนเลือกว่าขยายเท่าใดจึงมีประโยชน์

ข้อกำหนดตรงตัวจำกัดเฟรมเอาต์พุตที่ 13.75 หน่วยเมกะพิกเซลของผู้ผลิต หนึ่งหน่วยเท่ากับ 1,048,576 พิกเซล จึงสูงสุด 14,417,920 พิกเซล หรือประมาณ 14.4 ล้าน อธิบายที่มาของคำว่า 14.4 เมกะพิกเซลแบบปัดเศษในคู่มือ ต้นฉบับใหญ่จึงอาจขยายได้น้อยกว่าตัวคูณที่ขอ ตรวจขนาดส่งมอบ แทนถือว่าคำขอ 3× ทำให้แต่ละด้านเป็นสามเท่าเสมอ

เพดานความละเอียดต้นฉบับที่เผยแพร่คือ 2560×1440 เวิร์กโฟลว์นี้เพิ่มแหล่งที่เข้าเกณฑ์ไปสู่ 4K และสูงกว่า ไม่รับต้นฉบับที่ใหญ่กว่าอยู่แล้วเพียงเพราะต้องการผลลัพธ์สูงขึ้น ลดขนาดหรือเตรียมสำเนาทำงานที่เหมาะก่อนใช้โปรไฟล์นี้ เก็บไฟล์บันทึกเดิมแยก เพื่อไม่ให้การเปรียบเทียบสุดท้ายมีเพียงไฟล์กลางที่ย่อแล้ว

เตรียมต้นฉบับสั้นและอ่านรายละเอียดได้

แนวทางทั่วไปจำกัดต้นฉบับยี่สิบวินาทีและห้าสิบ MB ส่งผ่าน URL วิดีโอหรือ MP4 ที่เข้ารหัส ข้ออ้างอิงละเอียดระบุว่าประมวลผลยี่สิบวินาทีแรก หากยาวเกินเล็กน้อยอาจประมวลผลถึงจุดนั้นเท่านั้น แต่ถ้ายาวเกินมากจะปฏิเสธ ไม่มีค่าความเผื่อเชิงตัวเลขเผยแพร่ จึงตัดช่วงที่ต้องการให้ไม่เกินยี่สิบวินาที แทนพึ่งพาพฤติกรรมขอบเขตที่ไม่ระบุ

เลือกเวอร์ชันที่บีบอัดน้อยที่สุด อาร์ติแฟกต์การบีบอัดจำกัดรายละเอียดจริงที่กู้คืนได้ และโหมดสร้างสรรค์อาจสร้างพื้นผิวสมเหตุผลโดยไม่พิสูจน์ว่าฉากเดิมมีอะไร ตัดต่อและเลือกช่วงให้เสร็จก่อนขยาย เช่น ทำช็อตสินค้าเสร็จ เลือกช่วงการกระทำที่ใช้ แล้วขยายเฉพาะส่วนนั้น โดยเก็บต้นฉบับไม่แก้ไว้เปรียบเทียบ

ผลลัพธ์คงเสียงต้นฉบับ ตรวจจังหวะกับภาพ โดยเฉพาะต้นและท้ายช่วงที่เลือก โปรไฟล์นี้ไม่มีตัวเลือกเฟรมเรตอิสระ การสร้างบทสนทนาใหม่ หรือการแก้ด้วยภาพอ้างอิง จุดประสงค์คือวิดีโอใหญ่ขึ้นพร้อมแนวรายละเอียดที่เลือก โดยคงข้อมูลเวลาและเสียงในช่วงที่ประมวลผล

เก็บและตรวจคลิปที่ส่งมอบ

เวิร์กโฟลว์เป็นแบบอะซิงโครนัส งานที่ส่งมีตัวระบุและตำแหน่งสถานะ เมื่อสำเร็จจะมีลิงก์ MP4 แบบลงนามที่หมดอายุประมาณหนึ่งชั่วโมง เก็บคลิปจริง ต้นฉบับ ตัวคูณ โหมด creativity และคำอธิบายเนื้อหา แทนพึ่งพาตำแหน่งชั่วคราว แยกสถานะล้มเหลวหรือถูกกลั่นกรองออกจากวิดีโอที่เสร็จแล้ว

ตรวจเฟรมเดี่ยวเรื่องใบหน้า เครื่องหมาย และการเปลี่ยนพื้นผิว แล้วดูทั้งลำดับเรื่องความต่อเนื่อง การเคลื่อนไหว และเสียงตรงภาพ โหมดแม่นยำและสร้างสรรค์ตอบโจทย์ภาพต่างกัน สิ่งส่งมอบที่ใช้ได้คือคลิปขยายที่ตรงเป้าหมายความเหมือนต้นฉบับ ณ ขนาดแสดงที่ต้องการ ความละเอียดสูงกว่าอย่างเดียวไม่พิสูจน์ว่าอัตลักษณ์ ข้อความ หรือรายละเอียดเล็กยังถูกต้อง

Ailoot Ultra · วิดีโอ POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

เริ่มต้น

อินพุตที่รองรับ: ข้อความ · รูปภาพ · เสียง · วิดีโอ
ผลลัพธ์: วิดีโอ

ใช้งานได้ใน 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
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่า	ตารางอัตราค่าบริการ	ปริมาณคาดการณ์	หน่วยคิดค่าบริการ	เงื่อนไขคิดค่าบริการ	จำนวนพิกเซลต่อเมกะพิกเซล	ค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน	ตารางอัตราค่าบริการอัตราพื้นฐาน	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการ—	เงื่อนไขคิดค่าบริการ—	จำนวนพิกเซลต่อเมกะพิกเซล—	ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าราคาวิดีโอ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการต่อเมกะพิกเซล-วินาที	เงื่อนไขคิดค่าบริการคุณภาพ: creative	จำนวนพิกเซลต่อเมกะพิกเซล1,048,576	ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.21 ต่อเมกะพิกเซล-วินาที
การตั้งค่าราคาวิดีโอ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการต่อเมกะพิกเซล-วินาที	เงื่อนไขคิดค่าบริการquality: precise	จำนวนพิกเซลต่อเมกะพิกเซล1,048,576	ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.15 ต่อเมกะพิกเซล-วินาที
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	หน่วยคิดค่าบริการ—	เงื่อนไขคิดค่าบริการ—	จำนวนพิกเซลต่อเมกะพิกเซล—	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $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

บันทึกไฟล์ที่สร้างเสร็จทั้งหมด

GET · ดึงไฟล์สื่อที่เสร็จสมบูรณ์ทั้งหมด

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 ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

black-forest-labs/flux-video-upscale

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

Black Forest Labs: FLUX Video Upscale