เอกสาร API ข้อมูลอ้างอิง SDK ข้อมูลอ้างอิง การใช้งาน Agent AI ทักษะ

วิดีโอ

ส่งคำขอสร้างวิดีโอ

ส่งงานสร้างวิดีโอแบบอะซิงโครนัส คืนค่า 202 ทันทีพร้อม id งาน (ขึ้นต้นด้วย vjob_) จากนั้น poll GET /api/v1/videos/{id} จนกว่า status จะเป็น completed แล้วดาวน์โหลดผ่าน unsigned_urls การคิดเงิน: จองเครดิตตอนส่งตาม duration × resolution และชำระตามจำนวนวินาทีที่ส่งมอบจริง (usage.cost ในการตอบกลับ poll)

POST/api/v1/videos

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

Body

modelจำเป็น

string

ID โมเดลสร้างวิดีโอ (รูปแบบมีคำนำหน้าผู้ให้บริการ)

Example: "alibaba/wan2.7-t2v"

promptจำเป็น

string

พรอมต์ข้อความอธิบายวิดีโอที่ต้องการสร้าง

duration

integer

ความยาววิดีโอเป็นวินาที ค่าเริ่มต้น 2 แต่ละโมเดลมีขอบเขตของตัวเอง เช่น reference-to-video (r2v) อยู่ที่ 2–10 วินาที ค่านอกช่วงจะคืน 400 ก่อนจองเครดิต

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

ระดับคุณภาพเอาต์พุต ค่าเริ่มต้น "720p" ระดับที่รองรับต่างกันตามโมเดล ระดับที่ไม่รองรับจะคืน 400 ก่อนจองเครดิต และข้อความผิดพลาดจะแสดงระดับที่โมเดลรองรับ

480p720p1080p

Example: "720p"

aspect_ratio

string

อัตราส่วนภาพ ค่าที่พบบ่อย: "16:9", "9:16", "1:1", "4:3", "3:4" ชุดจริงขึ้นกับโมเดล (บางโมเดลรับอัตราส่วนกว้างเช่น "21:9") ชุดที่ไม่รองรับคืน 400 ก่อนจองเครดิต โหมดที่รับเฟรมอินพุตใช้อัตราส่วนจากเฟรมและละเว้นฟิลด์นี้

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

ภาพคีย์เฟรมแรก/สุดท้าย (image-to-video, keyframe-to-video) รับสตริง URL หรืออ็อบเจ็กต์ { type: "image", image_url: { url }, frame_type: "first" | "last" }

input_references

object[] | string[]

สื่ออ้างอิง (reference-to-video): นำทางการสร้างด้วยรายการอ้างอิง — แนะนำรูปแบบอ็อบเจ็กต์ { type: "image", image_url: { url } } (รับสตริง URL ด้วย ถือเป็นภาพอ้างอิง) ภาพอ้างอิงรองรับกว้างที่สุด อ็อบเจ็กต์อ้างอิงเสียง/วิดีโอจะถูกส่งต่อตามเดิมและมีผลเฉพาะโมเดลที่รองรับ — โมเดลอื่นใช้เฉพาะภาพอ้างอิง เฉพาะโมเดลที่มีโหมด r2v เท่านั้นที่รับฟิลด์นี้

input_video

string | object

วิดีโอต้นฉบับ (เฉพาะโมเดลตัดต่อวิดีโอ; ฟิลด์ส่วนขยายของ BazaarLink) รับสตริง URL, { video_url: { url } } หรือ { url } โมเดลอื่นจะละเว้น การตัดต่อคิดเงินตามวินาทีต้นฉบับ + วินาทีเอาต์พุต

generate_audio

boolean

สร้างเสียงด้วยหรือไม่ มีผลเฉพาะโมเดลที่รองรับเสียง วินาทีที่มีเสียงคิดอัตราต่อวินาทีสูงกว่า

watermark

boolean

ใส่ลายน้ำบนเอาต์พุตหรือไม่ ค่าเริ่มต้น false — BazaarLink จะปิดลายน้ำเริ่มต้นของต้นทางให้ เว้นแต่คุณส่ง true อย่างชัดเจน

seed

number

seed สำหรับการสุ่ม การรับประกันผลซ้ำขึ้นกับโมเดล

callback_url

string

URL webhook ที่จะถูกเรียกเมื่องานถึงสถานะสุดท้าย ทำให้ไม่ต้อง poll รับเฉพาะ HTTPS และจะตรวจสอบ SSRF (ปฏิเสธที่อยู่ภายใน/ส่วนตัว) ก่อนจองเครดิตใด ๆ จะทำงานเพียงครั้งเดียวเท่านั้น จากคำขอที่ชนะการตัดสินสถานะสุดท้าย การส่งจะลองใหม่เมื่อล้มเหลว (2 ครั้ง หน่วง 2 วิ/8 วิ) และแม้ลองครบแล้วก็ไม่กระทบการเรียกเก็บเงินหรือสถานะจริงของงาน ไม่มีลายเซ็นใน v1 — ถือว่า callback เป็นเพียงคำใบ้ ให้ยืนยันสถานะ/จำนวนเงินด้วยการเรียก GET /v1/videos/{id} ด้วย API key ของคุณก่อนดำเนินการ ⚠️ unsigned_urls ใน webhook payload เป็น URL แบบสัมบูรณ์ ต่างจาก path แบบสัมพัทธ์ที่ endpoint poll คืนค่า

https:// only, ≤2048 chars

คู่มือเชิงลึก →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

ตัวอย่างการตอบกลับ

รับงานแล้ว (อะซิงโครนัส) poll สถานะผ่าน polling_url ที่คืนมา (GET /api/v1/videos/{id}) แนะนำเว้นช่วง ≥5 วินาที

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}