Higgsfield: DOP Lite

DOP Lite ทำให้ภาพที่ส่งให้เคลื่อนไหวด้วยเทมเพลตการเคลื่อนไหวตามเอกสาร ความแรงที่ปรับได้ และคำสั่งเป็นข้อความ ตัวเลือก dop-lite ตรงรุ่นนี้ใช้คำขอแปลงภาพเป็นวิดีโอ และคืนวิดีโอผ่านงานแบบอะซิงโครนัส

Ailoot Ultra · วิดีโอ POST /v1/videos dop-lite

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

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

DOP Lite ทำให้ภาพที่ให้เคลื่อนไหวผ่านขั้นตอนแปลงภาพเป็นวิดีโอที่ Higgsfield อธิบายไว้ ตัวเลือกรุ่นตรงตัวคือ dop-lite ใช้ dop-lite เป็นค่า model ระดับบนสุด และเป็นค่า model ภายในออบเจ็กต์ params ตามเอกสาร ภาพให้ข้อมูลด้านภาพ ส่วนเทมเพลตการเคลื่อนไหวและคำสั่งเป็นข้อความควบคุมการเคลื่อนไหวและเอฟเฟกต์ที่ร้องขอ

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

เอกสารของการดำเนินการระบุเทมเพลตการเคลื่อนไหวหนึ่งหรือสองรายการ เมื่อให้สองรายการ คู่มืออธิบายว่าเอฟเฟกต์จะรวมกัน คำอธิบายพรีเซ็ตมีทั้งการเคลื่อนกล้อง การหมุนตัวแบบ และการเปลี่ยนแปลงภาพ เช่น Dolly In อธิบายกล้องเคลื่อนเข้าใกล้ ส่วน 3D Rotation อธิบายตัวแบบหรือสินค้าหมุนอยู่กับที่ เลือกรหัสเทมเพลตที่มีในเอกสารให้ตรงกับลำดับการเคลื่อนไหวที่ต้องการ และเก็บแต่ละรหัสพร้อมค่าความแรง

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

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

ตัวควบคุม seed รับจำนวนเต็มตั้งแต่ 1 ถึง 1000000 บันทึก seed ที่เลือกพร้อมการตั้งค่าการสร้าง คำขอยังมีฟิลด์ seconds ชนิดจำนวนเต็ม เก็บค่าที่ใช้พร้อมคลิปที่ได้ และตรวจช่วงเวลาจริงกับการจัดกรอบภาพของคลิป ค่าบูลีน check_nsfw เปิดตัวกรองเนื้อหาที่เอกสารอธิบายและมีค่าเริ่มต้น true ตัวควบคุมเหล่านี้อยู่ในคำขอแปลงภาพเป็นวิดีโอ และควรคงความเชื่อมโยงกับโมเดลตรงรุ่นที่เลือก

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

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

Ailoot Ultra · วิดีโอ POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

เริ่มต้น

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

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · วิดีโอ POST /v1/videos

ขาเข้า: image, text
ขาออก: video

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด dop-lite เงื่อนไข: ตัวเลือกโมเดลของ Ailoot	ค่าเริ่มต้น—
ฟิลด์`params`	ประเภท`object`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: พารามิเตอร์ภาพเป็นวิดีโอ คงโครงสร้างห่อหุ้มนี้ไว้	ค่าเริ่มต้น—
ฟิลด์`params.model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด dop-lite เงื่อนไข: ใช้ตัวเลือกเดียวกับ model ระดับบนสุด	ค่าเริ่มต้น—
ฟิลด์`params.prompt`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: คงฟิลด์นี้ไว้ เอกสารระบุว่าสตริงว่างใช้ได้ คำแนะนำที่เขียนมีผลอย่างมากต่อเอฟเฟกต์การเคลื่อนไหวที่เลือก	ค่าเริ่มต้น—
ฟิลด์`params.seconds`	ประเภท`integer`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: ระยะเวลาที่ขอ ไม่ยืนยันช่วงหรือค่าเริ่มต้นตามเอกสาร	ค่าเริ่มต้น—
ฟิลด์`params.motions`	ประเภท`array`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: เลือกเทมเพลตการเคลื่อนไหวตามเอกสารหนึ่งหรือสองแบบ	ค่าเริ่มต้น—
ฟิลด์`params.motions[].id`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: ตัวระบุการเคลื่อนไหวในตัวอย่างคำขอที่ทำงานได้ตามเอกสาร	ค่าเริ่มต้น—
ฟิลด์`params.motions[].strength`	ประเภท`number`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด ขั้นต่ำ: 0 สูงสุด: 1 เงื่อนไข: ความเข้มของการเคลื่อนไหว: 0.3 อธิบายว่าเบา และ 1 ว่ารุนแรง	ค่าเริ่มต้น0.8
ฟิลด์`params.input_images`	ประเภท`array`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: ภาพอ้างอิง โดยใช้อาร์เรย์ของออบเจ็กต์ image_url ตามตัวอย่างที่ทำงานได้	ค่าเริ่มต้น—
ฟิลด์`params.input_images[].type`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด image_url เงื่อนไข: รูปแบบของข้อมูลอ้างอิง	ค่าเริ่มต้น—
ฟิลด์`params.input_images[].image_url`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: URL ภาพอ้างอิงจริงของคุณที่เข้าถึงได้	ค่าเริ่มต้น—
ฟิลด์`params.enhance_prompt`	ประเภท`boolean`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: การปรับปรุงพรอมป์ต์	ค่าเริ่มต้นtrue
ฟิลด์`params.check_nsfw`	ประเภท`boolean`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: การกรองเนื้อหา	ค่าเริ่มต้นtrue
ฟิลด์`params.seed`	ประเภท`integer`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด ขั้นต่ำ: 1 สูงสุด: 1,000,000 เงื่อนไข: ค่าตั้งต้นสุ่มเพื่อให้ผลลัพธ์สอดคล้องกัน	ค่าเริ่มต้น—
ฟิลด์`webhook`	ประเภท`object`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: การตั้งค่า webhook ตามเอกสารเป็นตัวเลือกที่ไม่บังคับ การเรียกผลลัพธ์ที่เป็นของคุณใช้พาธงานของ Ailoot	ค่าเริ่มต้น—
ฟิลด์`webhook.url`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: URL ของตัวรับของคุณ	ค่าเริ่มต้น—
ฟิลด์`webhook.secret`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: ค่าลับของตัวรับของคุณ	ค่าเริ่มต้น—
ฟิลด์`callback`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: ตัวรับ callback (ระบุหรือไม่ก็ได้) ตัวรับตามเอกสารตอบกลับด้วย HTTP 200	ค่าเริ่มต้น—

ชุดผสมของสื่ออินพุต

พารามิเตอร์และวงจรการทำงานของเมธอด

พารามิเตอร์	ข้อกำหนด
พารามิเตอร์`content_type`	ข้อกำหนดapplication/json
พารามิเตอร์`required`	ข้อกำหนดmodel, params
พารามิเตอร์`optional`	ข้อกำหนดparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
พารามิเตอร์`material_types`	ข้อกำหนดimage, text
พารามิเตอร์`additional_properties`	ข้อกำหนดtrue
พารามิเตอร์`validation_scope`	ข้อกำหนดโมเดลกำหนดเส้นทางคำขอ โครงสร้างห่อหุ้มพารามิเตอร์เป็นไปตามคำขอภาพเป็นวิดีโอที่สาธิตไว้

ชื่ออื่นของเมธอด: /v1/videos/generations

วงจรการทำงาน: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

ใช้ตัวเลือกโมเดลเดียวกันทั้งระดับบนสุดและภายใน params

สร้างเพียงครั้งเดียว จากนั้นใช้ id สาธารณะและ polling_url ที่ส่งกลับสำหรับการดำเนินการเดิม

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

แทนที่ YOUR_ACCESSIBLE_IMAGE_URL ในตัวอย่างด้วย URL ภาพอ้างอิงจริงของคุณ

ราคา

วิธีคำนวณค่าบริการสุดท้าย

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

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว: ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น: ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

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

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

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

การตั้งค่า	ตารางอัตราค่าบริการ	ปริมาณคาดการณ์	ค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน	ตารางอัตราค่าบริการอัตราพื้นฐาน	ปริมาณคาดการณ์—	ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $1.24 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

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

ตัวอย่างคำขอ

Ailoot Ultra · วิดีโอ

JSON · สร้างวิดีโอcurl · อ่านข้อมูลงานต้นฉบับ

{
  "model": "dop-lite",
  "params": {
    "model": "dop-lite",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

รับและบันทึกผลลัพธ์

Ailoot Ultra · วิดีโอ

เก็บงานที่ส่งกลับและสถานะของแต่ละงาน อ่านผลลัพธ์วิดีโอที่เสร็จสมบูรณ์และเป็นของคุณทั้งหมด

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก URL ที่ส่งกลับมาจริง

เรียกผลลัพธ์จริงที่เสร็จสมบูรณ์ทุกรายการ อย่าสมมติจำนวนตายตัว

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

เก็บการตอบกลับเดิมและตัวตนงานที่ส่งกลับ สถานะที่ไม่รู้จักหรือการส่งที่ไม่ชัดเจนไม่อนุญาตให้สร้างใหม่

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท	ความหมาย
ฟิลด์`id`	ประเภทstring	ความหมายตัวระบุงานหรือการดำเนินการสาธารณะของ Ailoot
ฟิลด์`provider_task_id`	ประเภทstring	ความหมายตัวระบุงานเดิม แยกจาก id สาธารณะ
ฟิลด์`polling_url`	ประเภทstring	ความหมายพาธค้นหาข้อมูลของ Ailoot ที่ส่งกลับ
ฟิลด์`jobs[].id`	ประเภทstring	ความหมายตัวระบุงานจริงที่ส่งกลับ
ฟิลด์`jobs[].status`	ประเภทstring	ความหมายสถานะของแต่ละงานที่ส่งกลับ
ฟิลด์`jobs[].results.raw.url`	ประเภทstring	ความหมายวิดีโอที่เสร็จสมบูรณ์แต่ละรายการเปิดให้เข้าถึงผ่าน URL ที่ลงลายเซ็นและเป็นของ Ailoot

ข้อผิดพลาดและขั้นตอนถัดไป

การตอบกลับ	เงื่อนไข	ขั้นตอนถัดไป
การตอบกลับ400 · `invalid_request_error`	เงื่อนไขJSON/โมเดลไม่ถูกต้อง หรือดัชนีเนื้อหาไม่ถูกต้อง	ขั้นตอนถัดไป
การตอบกลับ401 · `authentication_error`	เงื่อนไขคีย์ API ของ Ailoot ไม่ถูกต้อง	ขั้นตอนถัดไป
การตอบกลับ403 · `permission_error`	เงื่อนไขกลุ่มคีย์ API ไม่ได้รับอนุญาตให้ใช้เส้นทางสื่อนี้	ขั้นตอนถัดไป
การตอบกลับ404 · `not_found_error`	เงื่อนไขไม่พบงานเดิมหรือผลลัพธ์ที่ขอ หรือไม่ได้เป็นของผู้ใช้/คีย์ API/กลุ่มเดียวกัน	ขั้นตอนถัดไป
การตอบกลับ502 · `result_pending_check`	เงื่อนไขการส่งคำขอหรือสถานะเดิมไม่สมบูรณ์หรือไม่สามารถตรวจสอบให้สอดคล้องกันได้ ให้เก็บ ID เดิมไว้และอย่าส่งคำขอซ้ำ	ขั้นตอนถัดไป
การตอบกลับ503 · `result_pending_check`	เงื่อนไขยังอยู่ระหว่างตรวจสอบการผูกข้อมูล เส้นทาง หรือสื่อที่เป็นของคุณสำหรับการดำเนินการเดิม ให้ตรวจสอบการดำเนินการเดิมนั้นต่อ	ขั้นตอนถัดไป
การตอบกลับ503 · `server_error`	เงื่อนไขบริการสื่อหรือที่เก็บงานเดิมไม่พร้อมใช้งาน	ขั้นตอนถัดไป

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra dop-lite

ชื่อพาธเมธอดอื่น

/v1/videos/generations

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

dop-lite

FAQ · Higgsfield: DOP Lite

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/videos · dop-lite: image, text → video
คำขอใช้ฟิลด์ใดบ้าง?: POST /v1/videos · dop-lite: model, params, webhook, callback
มีข้อจำกัดใดบ้าง?: POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Lite