Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard เป็นโปรไฟล์วิดีโอ 720p ของ Kuaishou สำหรับบรีฟข้อความและภาพ สร้างฉากสามถึงสิบห้าวินาทีพร้อมเสียงโดยตรง สื่ออ้างอิงตัวแบบ เฟรมต้น/ท้ายกำกับ และการเล่าเรื่องช็อตเดียวหรือหลายช็อต
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Kling VIDEO 3.0 Standard เป็นโปรไฟล์ 720p ของ Kuaishou สำหรับสร้างฉากจากข้อความหรือภาพ ใช้เสียงโดยตรง สื่ออ้างอิงตัวแบบ และการเล่าหลายช็อตของรุ่น VIDEO 3.0 โดยยาวยืดหยุ่นสามถึงสิบห้าวินาที เหมาะพัฒนาแนวภาพ พรีวิวเรื่องสั้น หรือสร้างฉากกะทัดรัดที่มีการกระทำและเสียงกำหนดไว้
ฉากตามข้อความให้ระบุตัวแบบ สถานที่ การกระทำ แสง และกล้อง ฉากตามภาพให้เตรียมภาพเปิดที่แสดงรูปลักษณ์กับองค์ประกอบที่จะทำให้เคลื่อนไหวชัด เช่น ตัวละครข้างโต๊ะเวิร์กช็อป แล้วบอกให้หยิบวัตถุเล็กขณะกล้องเข้าหาการกระทำ แยกการเคลื่อนตัวแบบกับกล้องในถ้อยคำ
การสร้างหลายช็อตวางมุมครอบคลุมจากคำอธิบายอัตโนมัติได้ ส่วนแบบกำหนดเองให้เนื้อหาและระยะเวลารายช็อต โปรไฟล์นี้รับหนึ่งถึงหกช็อต ไม่เกิน 512 อักขระต่อช็อต อย่างน้อยช็อตละหนึ่งวินาที และรวมเวลาเท่าความยาวคลิป หากมุมต่อเนื่องเดียวสื่อฉากชัด บรีฟช็อตเดียวเลี่ยงช่วงเปลี่ยนไม่จำเป็นได้
สตอรีบอร์ดสั้นเริ่มมุมสถานที่ ไปการกระทำ แล้วจบรายละเอียดอธิบายผล ระบุตัวแบบที่ยังอยู่แต่ละช็อตและกรอบเปลี่ยนอย่างไร โหมดอัตโนมัติปรับมุมตามฉาก ส่วนลำดับกำหนดเองกำกับส่วนต่าง ๆ ตรง ๆ พรอมป์ต์เดี่ยวปกติรับสูงสุด 2,500 อักขระตามข้ออ้างอิงผู้ผลิต
ตัวควบคุมอ้างอิงช่วยยึดตัวละคร วัตถุ และสถานที่ ใช้สื่อชัดกับคำอธิบายคงที่ โปรไฟล์ตามภาพที่ระบุรับองค์ประกอบเตรียมไว้สูงสุดสามรายการ ในฉากสินค้าวาด ภาพอ้างอิงหนึ่งกำหนดวัตถุ ภาพเปิดกำหนดตำแหน่ง แล้วบรีฟการเคลื่อนบอกเหตุการณ์รอบข้าง ตรวจรูปลักษณ์ตลอดช็อต แทนถือว่าสื่อป้องกันทุกการเปลี่ยน
เฟรมต้นและท้ายกำกับการเปลี่ยนจากภาพไปองค์ประกอบจบที่ต้องการ ใช้เฟรมเชื่อมกันสมเหตุผลและบรรยายการกระทำระหว่างนั้น โปรไฟล์ภาพรับ JPG, JPEG และ PNG ไม่เกิน 10 MB ขนาดอย่างน้อย 300 พิกเซล อัตราส่วนภาพเริ่มระหว่าง 1:2.5 กับ 2.5:1 เตรียมภาพตามงาน ไม่ถือว่าคำอธิบายสตอรีบอร์ดใช้แทนชุดอินพุตกันได้
Standard สร้างเสียงโดยตรงได้เมื่อเปิดโหมด ข้ออ้างอิงผู้ผลิตตั้งเสียงปิดโดยปริยาย บรรยายประโยค บรรยากาศ และเสียงที่เกี่ยวข้องในฉาก VIDEO 3.0 รองรับคำพูดจีน อังกฤษ ญี่ปุ่น เกาหลี และสเปน รวมสลับภาษาและสำเนียงหรือภาษาถิ่นที่รองรับ คู่มือระบุว่าบทสนทนาภาษาอื่นจะแปลเป็นอังกฤษ ทำให้ผู้พูดชัดในฉากหลายตัวละคร และใช้ประโยคสั้นพอดีการแสดง
ตัวอย่างบทสนทนากำหนดประโยคให้ผู้พูด A ปฏิกิริยาที่เห็นให้ผู้พูด B และเปลี่ยนมุมตามการโต้ตอบ บรรยายเสียงสถานที่แยกจากบทสนทนา เพื่อไม่ให้เอฟเฟกต์พื้นหลังกลายเป็นคำสั่งคำพูดคลุมเครือ ใช้สื่อกำหนดรูปลักษณ์และข้อความกำหนดการกระทำกับคำพูด
ตัวหนังสือที่เห็นเป็นอีกส่วนของ 3.0 ภาพต้นฉบับอาจมีป้าย คำบรรยาย หรือฉลากสินค้าที่ต้องรักษาขณะเคลื่อนไหว ระบุข้อความและบทบาท แล้วตรวจการสะกด ความอ่านง่าย และความนิ่ง สำหรับภาพแคมเปญสั้นให้ข้อความหลักเด่นในองค์ประกอบ แทนพึ่งฉลากพื้นหลังเล็กมาก
Standard ส่งออก 720p ส่วน Pro เป็นโปรไฟล์ 1080p ที่เลือกแยก และ 4K โดยตรงเป็นอีกโหมดผู้ผลิต ไม่ใช่ค่า Standard อัตโนมัติ อัตราส่วนแบบข้อความรวม 16:9, 9:16 และ 1:1 เลือกรูปแบบกับกรอบตามตำแหน่งใช้ และรักษาแนวภาพนั้นเมื่อเทียบการเปลี่ยนการกระทำ แสง หรือลำดับช็อต
ผลสำเร็จให้วิดีโอกับความยาวจริง เอกสารระบุว่าลบวิดีโอหลัง 30 วัน จึงเก็บทันที พร้อมบรีฟ ภาพอ้างอิง และโปรไฟล์เพื่อฐานแก้ที่คงที่ ตรวจการกระทำ ความต่อเนื่องตัวแบบ มุมกล้อง บทสนทนา และตัวหนังสือในบริบทใช้งาน การแก้รายละเอียดที่พลาดเฉพาะจุดมีประโยชน์กว่าเปลี่ยนบรีฟทั้งหมดเป็นคำสั่งไม่เกี่ยวกัน
Ailoot Ultra · วิดีโอ POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdเริ่มต้น
Kling VIDEO 3.0 Standard เป็นโปรไฟล์วิดีโอ 720p ของ Kuaishou สำหรับบรีฟข้อความและภาพ สร้างฉากสามถึงสิบห้าวินาทีพร้อมเสียงโดยตรง สื่ออ้างอิงตัวแบบ เฟรมต้น/ท้ายกำกับ และการเล่าเรื่องช็อตเดียวหรือหลายช็อต
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- วิดีโอ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · วิดีโอ POST /v1/videos
- ขาเข้า
text,image- ขาออก
video- รูปแบบเอาต์พุต
- ไบต์ MP4 ต้นฉบับ; ไม่ปรับมาตรฐานหรือแปลงรหัส
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด kwaivgi/kling-v3.0-std | ค่าเริ่มต้น— |
ฟิลด์prompt | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์duration | ประเภทinteger | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ขั้นต่ำ: 1 สูงสุด: 600 | ค่าเริ่มต้น— |
ฟิลด์resolution | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 720p | ค่าเริ่มต้น— |
ฟิลด์aspect_ratio | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 16:9, 9:16, 1:1 | ค่าเริ่มต้น— |
ฟิลด์generate_audio | ประเภทboolean | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด false, true เงื่อนไข: การไม่ระบุตัวเลือกนี้จะเลือกราคาที่เปิดใช้เสียง กำหนดเป็น false เพื่อเลือกราคาที่ไม่มีเสียง ตรวจสอบ has_audio ในผลลัพธ์เพื่อดูว่ามีการส่งแทร็กเสียงกลับหรือไม่ | ค่าเริ่มต้น— |
ฟิลด์frame_images | ประเภทarray | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด จำนวนรายการขั้นต่ำ: 1 จำนวนรายการสูงสุด: 2 เนื้อหาอินพุต: อาร์เรย์ของออบเจ็กต์เฟรม แต่ละออบเจ็กต์มี type=image_url, image_url ซึ่งมี url และ frame_type ใช้ URL ภาพ HTTPS และกำหนด frame_type เป็น first_frame หรือ last_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ชื่อคีย์ที่แน่นอน: type, image_url, frame_type เงื่อนไข: คีย์เหล่านี้อธิบายออบเจ็กต์เฟรมแต่ละรายการ image_url มีเฉพาะ url ไม่ต้องระบุ frame_images สำหรับคำขอที่มีเฉพาะข้อความ | ค่าเริ่มต้น— |
ฟิลด์input_references | ประเภทarray | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์size | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 1280x720, 720x1280, 720x720 แพตเทิร์น: ^[1-9][0-9]*x[1-9][0-9]*$ | ค่าเริ่มต้น— |
ฟิลด์callback_url | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด แพตเทิร์น: ^https:// | ค่าเริ่มต้น— |
ฟิลด์session_id | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์trace | ประเภทobject | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์user | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
สร้างวิดีโอจากข้อความ · พรอมป์ต์ข้อความ · จำเป็น: model, prompt, duration
ระบุพรอมป์ต์เป็นข้อความและระยะเวลาเป็นวินาทีเต็ม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้
model: ประเภท: string · kwaivgi/kling-v3.0-std
prompt: ประเภท: string · จำนวนไบต์ UTF-8 สูงสุด: 10,000 · ต้องมีอักขระที่ไม่ใช่ช่องว่าง: ใช่
สร้างวิดีโอจากภาพ · พรอมป์ต์ข้อความและภาพเฟรมแรก · จำเป็น: model, prompt, duration, frame_images
frame_images เป็นอาร์เรย์ ออบเจ็กต์ของแต่ละเฟรมมี type, image_url และ frame_type โดย image_url มี url กำหนด type เป็น image_url ใช้ first_frame และเพิ่ม last_frame ได้หากต้องการ แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ระบุ URL ภาพ HTTPS สาธารณะสำหรับแต่ละเฟรม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้
ชื่อคีย์ที่แน่นอน: type, image_url, frame_type
model: ประเภท: string · kwaivgi/kling-v3.0-std
prompt: ประเภท: string · จำนวนไบต์ UTF-8 สูงสุด: 10,000 · ต้องมีอักขระที่ไม่ใช่ช่องว่าง: ใช่
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์content_type | ข้อกำหนดapplication/json |
พารามิเตอร์required | ข้อกำหนดmodel, prompt, duration |
พารามิเตอร์material_types | ข้อกำหนดtext, image |
พารามิเตอร์additional_properties | ข้อกำหนดfalse |
พารามิเตอร์optional_controls | ข้อกำหนดresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
วงจรการทำงาน: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
ราคา
วิธีคำนวณค่าบริการสุดท้าย
อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ
ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก
- โหมดรวดเร็ว
- ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
- โหมดยืดหยุ่น
- ไม่ได้ระบุ เมื่อเลือกโหมด flex
- ระดับการใช้เหตุผลสูงสุด
- ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด
อัตราประมาณการเพื่อเปรียบเทียบ
ราคาตามการตั้งค่า
เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน
| การตั้งค่า | ตารางอัตราค่าบริการ | ปริมาณคาดการณ์ | รายการค่าบริการ | ความละเอียดข้อมูลอ้างอิง | โหมดอ้างอิง | เสียงอ้างอิง | หน่วยคิดค่าบริการ | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|---|---|---|---|---|---|---|
| การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน | ตารางอัตราค่าบริการอัตราพื้นฐาน | ปริมาณคาดการณ์— | รายการค่าบริการ— | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการ— | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น |
| การตั้งค่าวิดีโอขาออก · อัตราอ้างอิง | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการreference_output_rate | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการต่อวินาทีของเอาต์พุต | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · อัตราอ้างอิงต่อวินาทีของวิดีโอขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของเอาต์พุต |
| การตั้งค่าราคาวิดีโอ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการ— | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ | เงื่อนไขคิดค่าบริการเสียง: with_audio | ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.252 ต่อวินาทีของวิดีโอ |
| การตั้งค่าภาพเป็นวิดีโอ (ภาพเฟรม) · 1080p · อัตราอ้างอิง | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการreference_output_rate | ความละเอียดข้อมูลอ้างอิง1080p | โหมดอ้างอิงสร้างวิดีโอจากภาพ (ภาพเฟรม) | เสียงอ้างอิงไม่มีเสียง | หน่วยคิดค่าบริการต่อวินาทีของเอาต์พุต | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · อัตราอ้างอิงต่อวินาทีของวิดีโอขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของเอาต์พุต |
| การตั้งค่าราคาวิดีโอ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการ— | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: image_to_video; ความละเอียด: 720p | ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของวิดีโอ |
| การตั้งค่าข้อความเป็นวิดีโอ · 1080p · อัตราอ้างอิง | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการreference_output_rate | ความละเอียดข้อมูลอ้างอิง1080p | โหมดอ้างอิงสร้างวิดีโอจากข้อความ | เสียงอ้างอิงไม่มีเสียง | หน่วยคิดค่าบริการต่อวินาทีของเอาต์พุต | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · อัตราอ้างอิงต่อวินาทีของวิดีโอขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของเอาต์พุต |
| การตั้งค่าข้อความเป็นวิดีโอ · 480p · อัตราอ้างอิง | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการreference_output_rate | ความละเอียดข้อมูลอ้างอิง480p | โหมดอ้างอิงสร้างวิดีโอจากข้อความ | เสียงอ้างอิงไม่มีเสียง | หน่วยคิดค่าบริการต่อวินาทีของเอาต์พุต | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · อัตราอ้างอิงต่อวินาทีของวิดีโอขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของเอาต์พุต |
| การตั้งค่าราคาวิดีโอ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์— | รายการค่าบริการ— | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: text_to_video; ความละเอียด: 720p | ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.168 ต่อวินาทีของวิดีโอ |
| การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | รายการค่าบริการ— | ความละเอียดข้อมูลอ้างอิง— | โหมดอ้างอิง— | เสียงอ้างอิง— | หน่วยคิดค่าบริการ— | เงื่อนไขคิดค่าบริการ— | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.504 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
รายละเอียดอัตราอ้างอิง
ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก
ข้อมูลอ้างอิงราคาตามการตั้งค่าวิดีโอ
ราคาตามการตั้งค่า
เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน
| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้ | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการเสียง: with_audio | ค่าบริการ ขาออก · ราคาวิดีโอ $0.252 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: text_to_video; ความละเอียด: 480p | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: text_to_video; ความละเอียด: 720p | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: image_to_video; ความละเอียด: 720p | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: text_to_video; ความละเอียด: 1080p | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
| การตั้งค่าราคาวิดีโอ | เงื่อนไขคิดค่าบริการโหมดการสร้าง: image_to_video; ความละเอียด: 1080p | ค่าบริการ ขาออก · ราคาวิดีโอ $0.168 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง |
ตัวอย่างคำขอ
Ailoot Ultra · วิดีโอ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-std","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
รับและบันทึกผลลัพธ์
Ailoot Ultra · วิดีโอ
URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณ
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
ตรวจสอบสถานะงาน
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
การอ่านเนื้อหาแบบอื่น
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด
บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก URL ที่ส่งกลับมาจริง
เก็บผลลัพธ์จริงที่เป็นของคุณทุกรายการ พร้อมเมทาดาทาที่วัดได้ซึ่งส่งกลับมา
เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ
503 result_pending_check + id เดิม + X-Should-Retry:false ห้ามส่งคำขอเดิมซ้ำ
ฟิลด์การตอบกลับ
| ฟิลด์ | ประเภท | ความหมาย |
|---|---|---|
ฟิลด์index | ประเภทinteger | ความหมายตำแหน่งของวิดีโอนี้ในรายการผลลัพธ์ โดยเริ่มนับจากศูนย์ |
ฟิลด์content_url | ประเภทstring | ความหมายURL ดาวน์โหลด HTTPS ที่ลงลายเซ็นสำหรับวิดีโอที่เสร็จสมบูรณ์นี้ |
ฟิลด์sha256 | ประเภทstring | null | ความหมายค่าแฮช SHA-256 ของไบต์วิดีโอต้นฉบับ เป็น null หากไม่มีข้อมูล |
ฟิลด์size_bytes | ประเภทinteger | null | ความหมายขนาดไฟล์วิดีโอต้นฉบับเป็นไบต์ เป็น null หากไม่มีข้อมูล |
ฟิลด์duration_ms | ประเภทinteger | null | ความหมายระยะเวลาวิดีโอที่วัดได้เป็นมิลลิวินาที เป็น null หากไม่มีข้อมูล |
ฟิลด์width | ประเภทinteger | null | ความหมายความกว้างวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล |
ฟิลด์height | ประเภทinteger | null | ความหมายความสูงวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล |
ฟิลด์video_codec | ประเภทstring | null | ความหมายตัวระบุตัวแปลงสัญญาณวิดีโอ เป็น null หากไม่ได้บันทึกไว้ |
ฟิลด์has_audio | ประเภทboolean | null | ความหมายระบุว่าวิดีโอมีแทร็กเสียงหรือไม่ เป็น null หากไม่ได้วัด |
ฟิลด์audio_codec | ประเภทstring | null | ความหมายตัวระบุตัวแปลงสัญญาณเสียง เป็น null เมื่อไม่มีการบันทึกตัวระบุ |
ข้อผิดพลาดและขั้นตอนถัดไป
| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
|---|---|---|
การตอบกลับ404 · not_found_error | เงื่อนไขไม่สามารถเข้าถึงวิดีโอ หรือไม่พบ ID วิดีโอนี้ | ขั้นตอนถัดไปตรวจสอบสิทธิ์เข้าถึงวิดีโอ สำหรับวิดีโอที่มีอยู่ ให้ใช้ ID สาธารณะเดิมและคีย์ API เดิม |
การตอบกลับ401 · authentication_error | เงื่อนไขคีย์ API ไม่ตรงกับบัญชีที่ยืนยันตัวตน | ขั้นตอนถัดไปตรวจสอบคีย์ API และสิทธิ์เข้าถึงบัญชีของคุณก่อนส่ง |
การตอบกลับ400 · invalid_request_error | เงื่อนไขไม่สามารถอ่านคำขอ หรือดัชนีดาวน์โหลดไม่ถูกต้อง | ขั้นตอนถัดไปแก้ไขเนื้อหาคำขอ สำหรับการดาวน์โหลด ให้เลือกดัชนีผลลัพธ์ที่งานเดิมส่งกลับ |
การตอบกลับ422 · price_unavailable | เงื่อนไขไม่สามารถคิดราคาการตั้งค่าวิดีโอที่เลือกได้ | ขั้นตอนถัดไปเลือกการตั้งค่าวิดีโอที่รองรับและระบุตัวเลือกที่จำเป็นให้ครบก่อนส่งคำขอที่แก้ไขแล้ว |
การตอบกลับ422 · invalid_request_error | เงื่อนไขข้อมูลขาเข้าวิดีโอหรืองานต้นฉบับสำหรับการต่อเนื่องไม่ถูกต้อง | ขั้นตอนถัดไปใช้ข้อมูลขาเข้า HTTPS ที่ถูกต้อง สำหรับการต่อเนื่อง ให้ใช้ ID วิดีโอสาธารณะเดิมที่เสร็จสมบูรณ์ของคุณพร้อมคีย์ API เดิม |
การตอบกลับ402 · billing_error | เงื่อนไขยอดคงเหลือหรือขีดจำกัดที่ใช้ได้ไม่เพียงพอสำหรับการกันวงเงิน | ขั้นตอนถัดไปตรวจสอบยอดคงเหลือและขีดจำกัดที่ใช้ได้ก่อนส่งคำขอใหม่ |
การตอบกลับ503 · server_error | เงื่อนไขการตรวจสอบวิดีโอ ที่เก็บข้อมูล หรือการเข้าถึงบริการไม่พร้อมใช้งานชั่วคราว | ขั้นตอนถัดไปรอให้บริการพร้อมใช้งาน หากมี ID วิดีโอแล้ว ให้ตรวจสอบงานเดิมนั้นแทนการสร้างวิดีโออีกครั้ง |
การตอบกลับ503 · result_pending_check | เงื่อนไขต้องตรวจสอบผลลัพธ์วิดีโอเดิมและยอดเรียกเก็บ | ขั้นตอนถัดไปเก็บ ID วิดีโอที่ส่งกลับและตรวจสอบงานนั้น อย่าส่งคำขอสร้างทดแทนระหว่างที่กำลังตรวจสอบ |
การตอบกลับ503 · owned_result_unavailable | เงื่อนไขการดาวน์โหลดวิดีโอที่มีอยู่ไม่พร้อมใช้งานชั่วคราว | ขั้นตอนถัดไปตรวจสอบงานวิดีโอเดิมในภายหลังและดาวน์โหลดผลลัพธ์ที่มีอยู่ การสร้างใหม่จะสร้างการดำเนินการแยกต่างหาก |
การตอบกลับ409 · video_not_ready | เงื่อนไขเนื้อหาวิดีโอยังไม่เผยแพร่ | ขั้นตอนถัดไปตรวจสอบสถานะงานเดิม ดาวน์โหลดหลังรายงาน completed หากรายงาน failed ให้ทำตามข้อความแจ้งตรวจสอบยอดเรียกเก็บ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot Ultra kwaivgi/kling-v3.0-std
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Kling: Video v3.0 Standard
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/videos·kwaivgi/kling-v3.0-std:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- มีข้อจำกัดใดบ้าง?
POST /v1/videos·kwaivgi/kling-v3.0-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1