{ "aboutHtml": "

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

เลือกโหมดอินพุตให้ช็อต

ข้อความสู่วิดีโอเริ่มจากคำอธิบายฉาก รวมภาพและการเคลื่อนไหว ได้แก่ ตัวแบบ สถานที่ แสง กรอบ การกระทำ และกล้อง เหมาะฉากใหม่ B-roll เพลตพื้นหลัง หรือแนวคิดภาพที่เฟรมเริ่มไม่ต้องตรงภาพที่ส่ง

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

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

บรรยายภาพและการเคลื่อนไหวโดยตรง

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

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

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

ศัพท์กล้องและการกระทำเป็นลำดับ

คู่มือกล้องแยกกรอบ มุม การเคลื่อน และโฟกัส ภาพใกล้เปลี่ยนสิ่งที่เต็มเฟรม มุมต่ำเปลี่ยนทัศนมิติ แพนหมุนมุมมองกล้อง แทร็กติดตามตัวแบบ และ rack focus ย้ายโฟกัสระหว่างตัวแบบที่เห็น ระบุสิ่งที่ควรเห็นหรือเผยขณะกล้องเคลื่อน

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

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

ระยะเวลา ขนาด และเฟรมเรต

Gen-4.5 รองรับ 2–10 วินาที ตัวเลือกยาวรองรับหลายการกระทำตามลำดับ ส่วนปฏิกิริยาหรือเปิดเผยสั้นใช้ช็อตสั้นได้ เอาต์พุตที่ระบุคือ 720p ที่ 24 หรือ 25 เฟรมต่อวินาทีในโฟลว์ผู้ผลิต

ข้อความสู่วิดีโอระบุ 16:9 ที่ 1280 × 720 พิกเซล ภาพสู่วิดีโอเพิ่ม 9:16 ที่ 720 × 1280, 1:1 ที่ 960 × 960, 4:3 ที่ 1104 × 832, 3:4 ที่ 832 × 1104 และ 21:9 ที่ 1584 × 672 คงโหมดคู่กับขนาดจริง แทนถือว่าทั้งสองโหมดมีอัตราส่วนชุดเดียวกัน

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

สร้างลำดับยาวจากช็อตที่เสร็จแล้ว

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

เก็บเฟรมท้ายและบรีฟที่ตรงกัน เพื่อให้ช็อตใหม่เริ่มจากสภาพภาพที่ต้องการ ตรวจรูปลักษณ์ตัวแบบ ทิศกล้อง และช่วงเปลี่ยนในฟุตเทจต่อรวม

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

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

ใช้ Gen-4.5 ทำแนวคิดภาพยนตร์ ภาพแอนิเมชัน B-roll และพัฒนาฉากสั้น เก็บพรอมป์ต์ ภาพอินพุตถ้ามี ระยะเวลา โหมด และคลิปร่วมกัน ตรวจลำดับการกระทำ กล้อง รายละเอียดตัวแบบ คัตไม่ต้องการ และกรอบ แล้วแก้ช็อตอย่างเฉพาะจุด

", "aboutText": "Runway Gen-4.5 เป็นโมเดลสร้างวิดีโอแบบข้อความสู่วิดีโอและภาพสู่วิดีโอ ทำตามบรีฟองค์ประกอบฉาก การกระทำตัวแบบ การออกแบบกล้อง และลำดับเหตุการณ์ได้ ผลคือช็อตสั้นที่ตรวจ เก็บ หรือนำประกอบฟุตเทจอื่นได้\n\n### เลือกโหมดอินพุตให้ช็อต\n\nข้อความสู่วิดีโอเริ่มจากคำอธิบายฉาก รวมภาพและการเคลื่อนไหว ได้แก่ ตัวแบบ สถานที่ แสง กรอบ การกระทำ และกล้อง เหมาะฉากใหม่ B-roll เพลตพื้นหลัง หรือแนวคิดภาพที่เฟรมเริ่มไม่ต้องตรงภาพที่ส่ง\n\nภาพสู่วิดีโอเริ่มจากภาพที่เป็นเฟรมแรก ภาพให้ทั้งองค์ประกอบ เนื้อหา แสง และสไตล์ พรอมป์ต์ควรเน้นสิ่งถัดไป ได้แก่ การกระทำตัวแบบ การเคลื่อนไหวสิ่งแวดล้อม กล้อง และพัฒนาการช็อต\n\nเตรียมภาพชัดที่รายละเอียดสำคัญเห็นแล้ว ใบหน้า มือเบลอ หรืออาร์ติแฟกต์อาจเด่นขึ้นเมื่อเคลื่อนไหว สื่อที่สื่อความเร็วผ่านฝุ่นหรือโมชันเบลออาจขัดพรอมป์ต์ที่ขอตัวแบบอยู่นิ่ง\n\n### บรรยายภาพและการเคลื่อนไหวโดยตรง\n\nใช้ภาษาธรรมชาติชัดและคำอธิบายเชิงบวกของผลที่ต้องการ บรีฟข้อความสู่วิดีโอเริ่มมุมกล้อง ตัวแบบ และการกระทำ แล้วเติมแนวฉาก รายละเอียดมีประโยชน์เมื่อข้อกำหนดชัด ส่วนบรีฟง่ายเปิดพื้นที่สำรวจ ไม่มีจำนวนคำอุดมคติแทนความชัดเจนได้\n\nเช่น ภาพใกล้โคมทองเหลืองบนโต๊ะขณะเปิดไฟ ตามด้วยกล้องช้าเผยสมุดข้าง ๆ สำหรับข้อความสู่วิดีโอให้บอกวัสดุและแสง หากภาพที่ส่งกำหนดไว้แล้ว พรอมป์ต์ภาพสู่วิดีโอเน้นแสงเปลี่ยนกับกล้องเผยรายละเอียดได้\n\nหลีกเลี่ยงคำสั่งขัดกัน มุมล็อกนิ่งที่ตัวแบบขยับเล็กน้อยต่างจากแฮนด์เฮลด์แทร็กอย่างมีพลัง เติมรายละเอียดที่กำหนดช็อตมีประโยชน์แทนรายการสไตล์ไม่เกี่ยวกันยาว ๆ\n\n### ศัพท์กล้องและการกระทำเป็นลำดับ\n\nคู่มือกล้องแยกกรอบ มุม การเคลื่อน และโฟกัส ภาพใกล้เปลี่ยนสิ่งที่เต็มเฟรม มุมต่ำเปลี่ยนทัศนมิติ แพนหมุนมุมมองกล้อง แทร็กติดตามตัวแบบ และ rack focus ย้ายโฟกัสระหว่างตัวแบบที่เห็น ระบุสิ่งที่ควรเห็นหรือเผยขณะกล้องเคลื่อน\n\nพรอมป์ต์ลำดับเหตุการณ์ใช้ภาษาปกติหรือเวลาคร่าว ๆ ได้ เวลาใช้กำกับลำดับและจังหวะโดยประมาณ ไม่รับประกันแม่นระดับเฟรม ให้การกระทำมีเวลาเกิดตามธรรมชาติภายในคลิป\n\nสำหรับช็อตนิ่ง บรรยายการเคลื่อนไหวในเฟรมและย้ำกล้องคงที่ ผู้ผลิตระบุว่ามุมนิ่งสนิทอาจยาก โดยเฉพาะภาพกว้างหรือช็อตเปิดบางชนิด ตรวจการเคลื่อนเล็กที่ไม่ต้องการในผลจริง แทนถือว่าคำว่ากล้องนิ่งป้องกันได้ทั้งหมด\n\n### ระยะเวลา ขนาด และเฟรมเรต\n\nGen-4.5 รองรับ 2–10 วินาที ตัวเลือกยาวรองรับหลายการกระทำตามลำดับ ส่วนปฏิกิริยาหรือเปิดเผยสั้นใช้ช็อตสั้นได้ เอาต์พุตที่ระบุคือ 720p ที่ 24 หรือ 25 เฟรมต่อวินาทีในโฟลว์ผู้ผลิต\n\nข้อความสู่วิดีโอระบุ 16:9 ที่ 1280 × 720 พิกเซล ภาพสู่วิดีโอเพิ่ม 9:16 ที่ 720 × 1280, 1:1 ที่ 960 × 960, 4:3 ที่ 1104 × 832, 3:4 ที่ 832 × 1104 และ 21:9 ที่ 1584 × 672 คงโหมดคู่กับขนาดจริง แทนถือว่าทั้งสองโหมดมีอัตราส่วนชุดเดียวกัน\n\nอัตราส่วนภาพกำหนดองค์ประกอบเริ่มต้นได้ และการเปลี่ยนอาจครอปอินพุต ตรวจตำแหน่งตัวแบบก่อนประเมินการเคลื่อนไหว การกระทำถูกต้องไม่มีประโยชน์หากส่วนสำคัญของภาพถูกตัด\n\n### สร้างลำดับยาวจากช็อตที่เสร็จแล้ว\n\nงานตามภาพ ผู้ผลิตอธิบายการนำเฟรมสุดท้ายของคลิปสำเร็จเป็นภาพอินพุตการสร้างครั้งถัดไป แล้วรวมคลิปในโปรแกรมตัดต่อ โดยจัดการเฟรมร่วมและเวลาในงานตัดต่อ นี่เป็นหลายช็อตแยก ไม่ใช่การสร้างยาวไม่จำกัดครั้งเดียว\n\nเก็บเฟรมท้ายและบรีฟที่ตรงกัน เพื่อให้ช็อตใหม่เริ่มจากสภาพภาพที่ต้องการ ตรวจรูปลักษณ์ตัวแบบ ทิศกล้อง และช่วงเปลี่ยนในฟุตเทจต่อรวม\n\n### เก็บและตรวจสิ่งส่งมอบ\n\nหลังสร้างให้ตรวจคลิปทั้งหมดและเก็บเอาต์พุตสำเร็จ โฟลว์ผู้ผลิตมีการอัปสเกลและส่งออกงานแยก เช่น ProRes หรือลำดับ PNG เหล่านี้เป็นตัวเลือกเพิ่มเติม ขนาดสร้างโดยตรงยังแยกจากผลอัปสเกลภายหลัง\n\nใช้ Gen-4.5 ทำแนวคิดภาพยนตร์ ภาพแอนิเมชัน B-roll และพัฒนาฉากสั้น เก็บพรอมป์ต์ ภาพอินพุตถ้ามี ระยะเวลา โหมด และคลิปร่วมกัน ตรวจลำดับการกระทำ กล้อง รายละเอียดตัวแบบ คัตไม่ต้องการ และกรอบ แล้วแก้ช็อตอย่างเฉพาะจุด", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7fde453ddc5eb90f67735bc4a64c433e0553a5b8e9346c0fc456c0be06f81559", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "th", "methods": [ { "html": "
•

Runway: Gen-4.5

Runway /runway/gen-4.5

เริ่มต้น

Runway Gen-4.5 สร้างวิดีโอจากคำอธิบายฉากหรือภาพพร้อมทิศทางการเคลื่อนไหว คลิป 2–10 วินาที การกำกับกล้องชัดเจน และตัวเลือกองค์ประกอบแยกสำหรับข้อความสู่วิดีโอกับภาพสู่วิดีโอ เหมาะกับแนวคิดภาพยนตร์ B-roll และฉากภาพเคลื่อนไหว

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

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

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

เลือกโหมดอินพุตให้ช็อต

ข้อความสู่วิดีโอเริ่มจากคำอธิบายฉาก รวมภาพและการเคลื่อนไหว ได้แก่ ตัวแบบ สถานที่ แสง กรอบ การกระทำ และกล้อง เหมาะฉากใหม่ B-roll เพลตพื้นหลัง หรือแนวคิดภาพที่เฟรมเริ่มไม่ต้องตรงภาพที่ส่ง

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

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

บรรยายภาพและการเคลื่อนไหวโดยตรง

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

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

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

ศัพท์กล้องและการกระทำเป็นลำดับ

คู่มือกล้องแยกกรอบ มุม การเคลื่อน และโฟกัส ภาพใกล้เปลี่ยนสิ่งที่เต็มเฟรม มุมต่ำเปลี่ยนทัศนมิติ แพนหมุนมุมมองกล้อง แทร็กติดตามตัวแบบ และ rack focus ย้ายโฟกัสระหว่างตัวแบบที่เห็น ระบุสิ่งที่ควรเห็นหรือเผยขณะกล้องเคลื่อน

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

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

ระยะเวลา ขนาด และเฟรมเรต

Gen-4.5 รองรับ 2–10 วินาที ตัวเลือกยาวรองรับหลายการกระทำตามลำดับ ส่วนปฏิกิริยาหรือเปิดเผยสั้นใช้ช็อตสั้นได้ เอาต์พุตที่ระบุคือ 720p ที่ 24 หรือ 25 เฟรมต่อวินาทีในโฟลว์ผู้ผลิต

ข้อความสู่วิดีโอระบุ 16:9 ที่ 1280 × 720 พิกเซล ภาพสู่วิดีโอเพิ่ม 9:16 ที่ 720 × 1280, 1:1 ที่ 960 × 960, 4:3 ที่ 1104 × 832, 3:4 ที่ 832 × 1104 และ 21:9 ที่ 1584 × 672 คงโหมดคู่กับขนาดจริง แทนถือว่าทั้งสองโหมดมีอัตราส่วนชุดเดียวกัน

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

สร้างลำดับยาวจากช็อตที่เสร็จแล้ว

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

เก็บเฟรมท้ายและบรีฟที่ตรงกัน เพื่อให้ช็อตใหม่เริ่มจากสภาพภาพที่ต้องการ ตรวจรูปลักษณ์ตัวแบบ ทิศกล้อง และช่วงเปลี่ยนในฟุตเทจต่อรวม

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

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

ใช้ Gen-4.5 ทำแนวคิดภาพยนตร์ ภาพแอนิเมชัน B-roll และพัฒนาฉากสั้น เก็บพรอมป์ต์ ภาพอินพุตถ้ามี ระยะเวลา โหมด และคลิปร่วมกัน ตรวจลำดับการกระทำ กล้อง รายละเอียดตัวแบบ คัตไม่ต้องการ และกรอบ แล้วแก้ช็อตอย่างเฉพาะจุด

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

Ailoot Ultra · วิดีโอ POST /v1/videos
ขาเข้า
text, image
ขาออก
video
รูปแบบเอาต์พุต
ไบต์ MP4 ต้นฉบับ; ไม่ปรับมาตรฐานหรือแปลงรหัส
ฟิลด์ประเภทข้อกำหนดค่าและข้อจำกัดค่าเริ่มต้น
ฟิลด์modelประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
runway/gen-4.5
ค่าเริ่มต้น—
ฟิลด์promptประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัดค่าเริ่มต้น—
ฟิลด์durationประเภทintegerข้อกำหนดจำเป็นค่าและข้อจำกัด
2, 3, 4, 5, 6, 7, 8, 9, 10
ขั้นต่ำ: 1
สูงสุด: 600
ค่าเริ่มต้น—
ฟิลด์resolutionประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
720p
ค่าเริ่มต้น—
ฟิลด์aspect_ratioประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
16:9, 9:16
ค่าเริ่มต้น—
ฟิลด์generate_audioประเภทbooleanข้อกำหนดไม่บังคับค่าและข้อจำกัด
false
ค่าเริ่มต้น—
ฟิลด์frame_imagesประเภทarrayข้อกำหนดไม่บังคับค่าและข้อจำกัด
จำนวนรายการขั้นต่ำ: 1
จำนวนรายการสูงสุด: 1
เนื้อหาอินพุต: อาร์เรย์ของออบเจ็กต์เฟรม แต่ละออบเจ็กต์มี type=image_url, image_url ซึ่งมี url และ frame_type ใช้ URL ภาพ HTTPS และกำหนด frame_type เป็น first_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง
ชื่อคีย์ที่แน่นอน: type, image_url, frame_type
เงื่อนไข: คีย์เหล่านี้อธิบายออบเจ็กต์เฟรมแต่ละรายการ image_url มีเฉพาะ url ไม่ต้องระบุ frame_images สำหรับคำขอที่มีเฉพาะข้อความ
ค่าเริ่มต้น—
ฟิลด์input_referencesประเภทarrayข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
ฟิลด์sizeประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
1280x720, 720x1280
แพตเทิร์น: ^[1-9][0-9]*x[1-9][0-9]*$
ค่าเริ่มต้น—
ฟิลด์seedประเภทintegerข้อกำหนดไม่บังคับค่าและข้อจำกัด
ขั้นต่ำ: -9,223,372,036,854,775,808
สูงสุด: 9,223,372,036,854,775,807
ค่าเริ่มต้น—
ฟิลด์callback_urlประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
แพตเทิร์น: ^https://
ค่าเริ่มต้น—
ฟิลด์session_idประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
ฟิลด์traceประเภทobjectข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
ฟิลด์userประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
ชุดผสมของสื่ออินพุต

สร้างวิดีโอจากข้อความ · พรอมป์ต์ข้อความ · จำเป็น: model, prompt, duration

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

model: ประเภท: string · runway/gen-4.5

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 แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ระบุ URL ภาพ HTTPS สาธารณะสำหรับแต่ละเฟรม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้

ชื่อคีย์ที่แน่นอน: type, image_url, frame_type

model: ประเภท: string · runway/gen-4.5

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, seed, 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 โทเค็น
การตั้งค่าราคาวิดีโอตารางอัตราค่าบริการ—ปริมาณคาดการณ์—หน่วยคิดค่าบริการต่อวินาทีของวิดีโอเงื่อนไขคิดค่าบริการไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้ค่าบริการ
ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.24 ต่อวินาทีของวิดีโอ
การตั้งค่าต้นทุนการสร้างโดยประมาณตารางอัตราค่าบริการ—ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้งหน่วยคิดค่าบริการ—เงื่อนไขคิดค่าบริการ—ค่าบริการ
ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.48 ประมาณการก่อนสร้าง

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

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

รายละเอียดอัตราอ้างอิง

ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก

ข้อมูลอ้างอิงราคาตามการตั้งค่าวิดีโอ

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

การตั้งค่าเงื่อนไขคิดค่าบริการค่าบริการ
การตั้งค่าราคาวิดีโอเงื่อนไขคิดค่าบริการไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้ค่าบริการ
ขาออก · ราคาวิดีโอ $0.24 ต่อวินาทีของวิดีโอ

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

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

Ailoot Ultra · วิดีโอ

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"runway/gen-4.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

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

Ailoot Ultra · วิดีโอ

URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณ

ตรวจสอบสถานะงาน
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
การอ่านเนื้อหาแบบอื่น
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก 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 runway/gen-4.5

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

ใช้พาธเมธอดที่แสดงด้านบน

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

runway/gen-4.5

", "method_identity": { "effective_request_model_id": "runway/gen-4.5", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|runway%2Fgen-4.5", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "เก็บผลลัพธ์จริงที่เป็นของคุณทุกรายการ พร้อมเมทาดาทาที่วัดได้ซึ่งส่งกลับมา", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "ไม่สามารถเข้าถึงวิดีโอ หรือไม่พบ ID วิดีโอนี้", "http_status": 404, "public_identifier_field": "error.type", "recovery": "ตรวจสอบสิทธิ์เข้าถึงวิดีโอ สำหรับวิดีโอที่มีอยู่ ให้ใช้ ID สาธารณะเดิมและคีย์ API เดิม", "type": "not_found_error" }, { "condition": "คีย์ API ไม่ตรงกับบัญชีที่ยืนยันตัวตน", "http_status": 401, "public_identifier_field": "error.type", "recovery": "ตรวจสอบคีย์ API และสิทธิ์เข้าถึงบัญชีของคุณก่อนส่ง", "type": "authentication_error" }, { "condition": "ไม่สามารถอ่านคำขอ หรือดัชนีดาวน์โหลดไม่ถูกต้อง", "http_status": 400, "public_identifier_field": "error.type", "recovery": "แก้ไขเนื้อหาคำขอ สำหรับการดาวน์โหลด ให้เลือกดัชนีผลลัพธ์ที่งานเดิมส่งกลับ", "type": "invalid_request_error" }, { "condition": "ไม่สามารถคิดราคาการตั้งค่าวิดีโอที่เลือกได้", "http_status": 422, "public_identifier_field": "error.type", "recovery": "เลือกการตั้งค่าวิดีโอที่รองรับและระบุตัวเลือกที่จำเป็นให้ครบก่อนส่งคำขอที่แก้ไขแล้ว", "type": "price_unavailable" }, { "condition": "ข้อมูลขาเข้าวิดีโอหรืองานต้นฉบับสำหรับการต่อเนื่องไม่ถูกต้อง", "http_status": 422, "public_identifier_field": "error.type", "recovery": "ใช้ข้อมูลขาเข้า HTTPS ที่ถูกต้อง สำหรับการต่อเนื่อง ให้ใช้ ID วิดีโอสาธารณะเดิมที่เสร็จสมบูรณ์ของคุณพร้อมคีย์ API เดิม", "type": "invalid_request_error" }, { "condition": "ยอดคงเหลือหรือขีดจำกัดที่ใช้ได้ไม่เพียงพอสำหรับการกันวงเงิน", "http_status": 402, "public_identifier_field": "error.type", "recovery": "ตรวจสอบยอดคงเหลือและขีดจำกัดที่ใช้ได้ก่อนส่งคำขอใหม่", "type": "billing_error" }, { "condition": "การตรวจสอบวิดีโอ ที่เก็บข้อมูล หรือการเข้าถึงบริการไม่พร้อมใช้งานชั่วคราว", "http_status": 503, "public_identifier_field": "error.type", "recovery": "รอให้บริการพร้อมใช้งาน หากมี ID วิดีโอแล้ว ให้ตรวจสอบงานเดิมนั้นแทนการสร้างวิดีโออีกครั้ง", "type": "server_error" }, { "code": "result_pending_check", "condition": "ต้องตรวจสอบผลลัพธ์วิดีโอเดิมและยอดเรียกเก็บ", "http_status": 503, "public_identifier_field": "error.code", "recovery": "เก็บ ID วิดีโอที่ส่งกลับและตรวจสอบงานนั้น อย่าส่งคำขอสร้างทดแทนระหว่างที่กำลังตรวจสอบ", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "การดาวน์โหลดวิดีโอที่มีอยู่ไม่พร้อมใช้งานชั่วคราว", "http_status": 503, "public_identifier_field": "error.code", "recovery": "ตรวจสอบงานวิดีโอเดิมในภายหลังและดาวน์โหลดผลลัพธ์ที่มีอยู่ การสร้างใหม่จะสร้างการดำเนินการแยกต่างหาก", "type": "server_error" }, { "condition": "เนื้อหาวิดีโอยังไม่เผยแพร่", "http_status": 409, "public_identifier_field": "error.type", "recovery": "ตรวจสอบสถานะงานเดิม ดาวน์โหลดหลังรายงาน completed หากรายงาน failed ให้ทำตามข้อความแจ้งตรวจสอบยอดเรียกเก็บ", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id เดิม + X-Should-Retry:false ห้ามส่งคำขอเดิมซ้ำ" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "ระบุพรอมป์ต์เป็นข้อความและระยะเวลาเป็นวินาทีเต็ม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้", "required": [ "model", "prompt", "duration" ], "required_material": "พรอมป์ต์ข้อความ" }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images เป็นอาร์เรย์ ออบเจ็กต์ของแต่ละเฟรมมี type, image_url และ frame_type โดย image_url มี url กำหนด type เป็น image_url ใช้ first_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ระบุ URL ภาพ HTTPS สาธารณะสำหรับแต่ละเฟรม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "พรอมป์ต์ข้อความและภาพเฟรมแรก" } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "ตำแหน่งของวิดีโอนี้ในรายการผลลัพธ์ โดยเริ่มนับจากศูนย์", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL ดาวน์โหลด HTTPS ที่ลงลายเซ็นสำหรับวิดีโอที่เสร็จสมบูรณ์นี้", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "ค่าแฮช SHA-256 ของไบต์วิดีโอต้นฉบับ เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "ขนาดไฟล์วิดีโอต้นฉบับเป็นไบต์ เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "ระยะเวลาวิดีโอที่วัดได้เป็นมิลลิวินาที เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ความกว้างวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ความสูงวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "ตัวระบุตัวแปลงสัญญาณวิดีโอ เป็น null หากไม่ได้บันทึกไว้", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "ระบุว่าวิดีโอมีแทร็กเสียงหรือไม่ เป็น null หากไม่ได้วัด", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "ตัวระบุตัวแปลงสัญญาณเสียง เป็น null เมื่อไม่มีการบันทึกตัวระบุ", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณ", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "คีย์เหล่านี้อธิบายออบเจ็กต์เฟรมแต่ละรายการ image_url มีเฉพาะ url ไม่ต้องระบุ frame_images สำหรับคำขอที่มีเฉพาะข้อความ", "content": "อาร์เรย์ของออบเจ็กต์เฟรม แต่ละออบเจ็กต์มี type=image_url, image_url ซึ่งมี url และ frame_type ใช้ URL ภาพ HTTPS และกำหนด frame_type เป็น first_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "ต้นทุนการสร้างโดยประมาณ", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "runway/gen-4.5", "nativeProvenance": { "input_facts_canonical_sha256": "188001002679a4db2b5672a5bad5a5e698c7ee7ed4d073af6251a9c3b25eeb89", "input_html_sha256": "f2309b709d66ee37aa1b5db9b7fa53b78da0d738d9453597f7821b6659f65b21", "private_audit_sha256": "b6aa5a937c3ec529660ebacec08d0abc3bbacd6d906205dc4a73a9c2854c3ea1", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/th/runway-gen-4-5/", "description": "Runway Gen-4.5 สร้างวิดีโอจากคำอธิบายฉากหรือภาพพร้อมทิศทางการเคลื่อนไหว คลิป 2–10 วินาที การกำกับกล้องชัดเจน และตัวเลือกองค์ประกอบแยกสำหรับข้อความสู่วิดีโอกับภาพสู่วิดีโอ เหมาะกับแนวคิดภาพยนตร์ B-roll และฉากภาพเคลื่อนไหว", "locale": "th", "md_url": "https://ailoot.ai/models/th/runway-gen-4-5/index.md", "title": "Runway: Gen-4.5 — Ailoot", "url": "https://ailoot.ai/models/th/runway-gen-4-5/" }, "rawModel": { "about": "Runway Gen-4.5 เป็นโมเดลสร้างวิดีโอแบบข้อความสู่วิดีโอและภาพสู่วิดีโอ ทำตามบรีฟองค์ประกอบฉาก การกระทำตัวแบบ การออกแบบกล้อง และลำดับเหตุการณ์ได้ ผลคือช็อตสั้นที่ตรวจ เก็บ หรือนำประกอบฟุตเทจอื่นได้\n\n### เลือกโหมดอินพุตให้ช็อต\n\nข้อความสู่วิดีโอเริ่มจากคำอธิบายฉาก รวมภาพและการเคลื่อนไหว ได้แก่ ตัวแบบ สถานที่ แสง กรอบ การกระทำ และกล้อง เหมาะฉากใหม่ B-roll เพลตพื้นหลัง หรือแนวคิดภาพที่เฟรมเริ่มไม่ต้องตรงภาพที่ส่ง\n\nภาพสู่วิดีโอเริ่มจากภาพที่เป็นเฟรมแรก ภาพให้ทั้งองค์ประกอบ เนื้อหา แสง และสไตล์ พรอมป์ต์ควรเน้นสิ่งถัดไป ได้แก่ การกระทำตัวแบบ การเคลื่อนไหวสิ่งแวดล้อม กล้อง และพัฒนาการช็อต\n\nเตรียมภาพชัดที่รายละเอียดสำคัญเห็นแล้ว ใบหน้า มือเบลอ หรืออาร์ติแฟกต์อาจเด่นขึ้นเมื่อเคลื่อนไหว สื่อที่สื่อความเร็วผ่านฝุ่นหรือโมชันเบลออาจขัดพรอมป์ต์ที่ขอตัวแบบอยู่นิ่ง\n\n### บรรยายภาพและการเคลื่อนไหวโดยตรง\n\nใช้ภาษาธรรมชาติชัดและคำอธิบายเชิงบวกของผลที่ต้องการ บรีฟข้อความสู่วิดีโอเริ่มมุมกล้อง ตัวแบบ และการกระทำ แล้วเติมแนวฉาก รายละเอียดมีประโยชน์เมื่อข้อกำหนดชัด ส่วนบรีฟง่ายเปิดพื้นที่สำรวจ ไม่มีจำนวนคำอุดมคติแทนความชัดเจนได้\n\nเช่น ภาพใกล้โคมทองเหลืองบนโต๊ะขณะเปิดไฟ ตามด้วยกล้องช้าเผยสมุดข้าง ๆ สำหรับข้อความสู่วิดีโอให้บอกวัสดุและแสง หากภาพที่ส่งกำหนดไว้แล้ว พรอมป์ต์ภาพสู่วิดีโอเน้นแสงเปลี่ยนกับกล้องเผยรายละเอียดได้\n\nหลีกเลี่ยงคำสั่งขัดกัน มุมล็อกนิ่งที่ตัวแบบขยับเล็กน้อยต่างจากแฮนด์เฮลด์แทร็กอย่างมีพลัง เติมรายละเอียดที่กำหนดช็อตมีประโยชน์แทนรายการสไตล์ไม่เกี่ยวกันยาว ๆ\n\n### ศัพท์กล้องและการกระทำเป็นลำดับ\n\nคู่มือกล้องแยกกรอบ มุม การเคลื่อน และโฟกัส ภาพใกล้เปลี่ยนสิ่งที่เต็มเฟรม มุมต่ำเปลี่ยนทัศนมิติ แพนหมุนมุมมองกล้อง แทร็กติดตามตัวแบบ และ rack focus ย้ายโฟกัสระหว่างตัวแบบที่เห็น ระบุสิ่งที่ควรเห็นหรือเผยขณะกล้องเคลื่อน\n\nพรอมป์ต์ลำดับเหตุการณ์ใช้ภาษาปกติหรือเวลาคร่าว ๆ ได้ เวลาใช้กำกับลำดับและจังหวะโดยประมาณ ไม่รับประกันแม่นระดับเฟรม ให้การกระทำมีเวลาเกิดตามธรรมชาติภายในคลิป\n\nสำหรับช็อตนิ่ง บรรยายการเคลื่อนไหวในเฟรมและย้ำกล้องคงที่ ผู้ผลิตระบุว่ามุมนิ่งสนิทอาจยาก โดยเฉพาะภาพกว้างหรือช็อตเปิดบางชนิด ตรวจการเคลื่อนเล็กที่ไม่ต้องการในผลจริง แทนถือว่าคำว่ากล้องนิ่งป้องกันได้ทั้งหมด\n\n### ระยะเวลา ขนาด และเฟรมเรต\n\nGen-4.5 รองรับ 2–10 วินาที ตัวเลือกยาวรองรับหลายการกระทำตามลำดับ ส่วนปฏิกิริยาหรือเปิดเผยสั้นใช้ช็อตสั้นได้ เอาต์พุตที่ระบุคือ 720p ที่ 24 หรือ 25 เฟรมต่อวินาทีในโฟลว์ผู้ผลิต\n\nข้อความสู่วิดีโอระบุ 16:9 ที่ 1280 × 720 พิกเซล ภาพสู่วิดีโอเพิ่ม 9:16 ที่ 720 × 1280, 1:1 ที่ 960 × 960, 4:3 ที่ 1104 × 832, 3:4 ที่ 832 × 1104 และ 21:9 ที่ 1584 × 672 คงโหมดคู่กับขนาดจริง แทนถือว่าทั้งสองโหมดมีอัตราส่วนชุดเดียวกัน\n\nอัตราส่วนภาพกำหนดองค์ประกอบเริ่มต้นได้ และการเปลี่ยนอาจครอปอินพุต ตรวจตำแหน่งตัวแบบก่อนประเมินการเคลื่อนไหว การกระทำถูกต้องไม่มีประโยชน์หากส่วนสำคัญของภาพถูกตัด\n\n### สร้างลำดับยาวจากช็อตที่เสร็จแล้ว\n\nงานตามภาพ ผู้ผลิตอธิบายการนำเฟรมสุดท้ายของคลิปสำเร็จเป็นภาพอินพุตการสร้างครั้งถัดไป แล้วรวมคลิปในโปรแกรมตัดต่อ โดยจัดการเฟรมร่วมและเวลาในงานตัดต่อ นี่เป็นหลายช็อตแยก ไม่ใช่การสร้างยาวไม่จำกัดครั้งเดียว\n\nเก็บเฟรมท้ายและบรีฟที่ตรงกัน เพื่อให้ช็อตใหม่เริ่มจากสภาพภาพที่ต้องการ ตรวจรูปลักษณ์ตัวแบบ ทิศกล้อง และช่วงเปลี่ยนในฟุตเทจต่อรวม\n\n### เก็บและตรวจสิ่งส่งมอบ\n\nหลังสร้างให้ตรวจคลิปทั้งหมดและเก็บเอาต์พุตสำเร็จ โฟลว์ผู้ผลิตมีการอัปสเกลและส่งออกงานแยก เช่น ProRes หรือลำดับ PNG เหล่านี้เป็นตัวเลือกเพิ่มเติม ขนาดสร้างโดยตรงยังแยกจากผลอัปสเกลภายหลัง\n\nใช้ Gen-4.5 ทำแนวคิดภาพยนตร์ ภาพแอนิเมชัน B-roll และพัฒนาฉากสั้น เก็บพรอมป์ต์ ภาพอินพุตถ้ามี ระยะเวลา โหมด และคลิปร่วมกัน ตรวจลำดับการกระทำ กล้อง รายละเอียดตัวแบบ คัตไม่ต้องการ และกรอบ แล้วแก้ช็อตอย่างเฉพาะจุด", "alias_of": null, "aliases": [], "author": "Runway", "available": null, "canonical_model": "runway/gen-4.5", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "ดูราคาตามการกำหนดค่าแบบครบถ้วนในรายละเอียด" } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "cb4a8a486aaac9d58ece6322", "label": "ข้อมูลอ้างอิงราคาตามการตั้งค่าวิดีโอ", "profiles": [ { "basis": "ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง", "dimensions": { "conditions": "ไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้" }, "label": "ราคาวิดีโอ", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "runway/gen-4.5", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "เก็บผลลัพธ์จริงที่เป็นของคุณทุกรายการ พร้อมเมทาดาทาที่วัดได้ซึ่งส่งกลับมา", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "ไม่สามารถเข้าถึงวิดีโอ หรือไม่พบ ID วิดีโอนี้", "http_status": 404, "public_identifier_field": "error.type", "recovery": "ตรวจสอบสิทธิ์เข้าถึงวิดีโอ สำหรับวิดีโอที่มีอยู่ ให้ใช้ ID สาธารณะเดิมและคีย์ API เดิม", "type": "not_found_error" }, { "condition": "คีย์ API ไม่ตรงกับบัญชีที่ยืนยันตัวตน", "http_status": 401, "public_identifier_field": "error.type", "recovery": "ตรวจสอบคีย์ API และสิทธิ์เข้าถึงบัญชีของคุณก่อนส่ง", "type": "authentication_error" }, { "condition": "ไม่สามารถอ่านคำขอ หรือดัชนีดาวน์โหลดไม่ถูกต้อง", "http_status": 400, "public_identifier_field": "error.type", "recovery": "แก้ไขเนื้อหาคำขอ สำหรับการดาวน์โหลด ให้เลือกดัชนีผลลัพธ์ที่งานเดิมส่งกลับ", "type": "invalid_request_error" }, { "condition": "ไม่สามารถคิดราคาการตั้งค่าวิดีโอที่เลือกได้", "http_status": 422, "public_identifier_field": "error.type", "recovery": "เลือกการตั้งค่าวิดีโอที่รองรับและระบุตัวเลือกที่จำเป็นให้ครบก่อนส่งคำขอที่แก้ไขแล้ว", "type": "price_unavailable" }, { "condition": "ข้อมูลขาเข้าวิดีโอหรืองานต้นฉบับสำหรับการต่อเนื่องไม่ถูกต้อง", "http_status": 422, "public_identifier_field": "error.type", "recovery": "ใช้ข้อมูลขาเข้า HTTPS ที่ถูกต้อง สำหรับการต่อเนื่อง ให้ใช้ ID วิดีโอสาธารณะเดิมที่เสร็จสมบูรณ์ของคุณพร้อมคีย์ API เดิม", "type": "invalid_request_error" }, { "condition": "ยอดคงเหลือหรือขีดจำกัดที่ใช้ได้ไม่เพียงพอสำหรับการกันวงเงิน", "http_status": 402, "public_identifier_field": "error.type", "recovery": "ตรวจสอบยอดคงเหลือและขีดจำกัดที่ใช้ได้ก่อนส่งคำขอใหม่", "type": "billing_error" }, { "condition": "การตรวจสอบวิดีโอ ที่เก็บข้อมูล หรือการเข้าถึงบริการไม่พร้อมใช้งานชั่วคราว", "http_status": 503, "public_identifier_field": "error.type", "recovery": "รอให้บริการพร้อมใช้งาน หากมี ID วิดีโอแล้ว ให้ตรวจสอบงานเดิมนั้นแทนการสร้างวิดีโออีกครั้ง", "type": "server_error" }, { "code": "result_pending_check", "condition": "ต้องตรวจสอบผลลัพธ์วิดีโอเดิมและยอดเรียกเก็บ", "http_status": 503, "public_identifier_field": "error.code", "recovery": "เก็บ ID วิดีโอที่ส่งกลับและตรวจสอบงานนั้น อย่าส่งคำขอสร้างทดแทนระหว่างที่กำลังตรวจสอบ", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "การดาวน์โหลดวิดีโอที่มีอยู่ไม่พร้อมใช้งานชั่วคราว", "http_status": 503, "public_identifier_field": "error.code", "recovery": "ตรวจสอบงานวิดีโอเดิมในภายหลังและดาวน์โหลดผลลัพธ์ที่มีอยู่ การสร้างใหม่จะสร้างการดำเนินการแยกต่างหาก", "type": "server_error" }, { "condition": "เนื้อหาวิดีโอยังไม่เผยแพร่", "http_status": 409, "public_identifier_field": "error.type", "recovery": "ตรวจสอบสถานะงานเดิม ดาวน์โหลดหลังรายงาน completed หากรายงาน failed ให้ทำตามข้อความแจ้งตรวจสอบยอดเรียกเก็บ", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id เดิม + X-Should-Retry:false ห้ามส่งคำขอเดิมซ้ำ" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "ระบุพรอมป์ต์เป็นข้อความและระยะเวลาเป็นวินาทีเต็ม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้", "required": [ "model", "prompt", "duration" ], "required_material": "พรอมป์ต์ข้อความ" }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images เป็นอาร์เรย์ ออบเจ็กต์ของแต่ละเฟรมมี type, image_url และ frame_type โดย image_url มี url กำหนด type เป็น image_url ใช้ first_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ระบุ URL ภาพ HTTPS สาธารณะสำหรับแต่ละเฟรม เลือกความละเอียดที่รองรับ เพิ่มอัตราส่วนภาพหรือใช้ขนาดที่ระบุไว้", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "พรอมป์ต์ข้อความและภาพเฟรมแรก" } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "ตำแหน่งของวิดีโอนี้ในรายการผลลัพธ์ โดยเริ่มนับจากศูนย์", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL ดาวน์โหลด HTTPS ที่ลงลายเซ็นสำหรับวิดีโอที่เสร็จสมบูรณ์นี้", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "ค่าแฮช SHA-256 ของไบต์วิดีโอต้นฉบับ เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "ขนาดไฟล์วิดีโอต้นฉบับเป็นไบต์ เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "ระยะเวลาวิดีโอที่วัดได้เป็นมิลลิวินาที เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ความกว้างวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ความสูงวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "ตัวระบุตัวแปลงสัญญาณวิดีโอ เป็น null หากไม่ได้บันทึกไว้", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "ระบุว่าวิดีโอมีแทร็กเสียงหรือไม่ เป็น null หากไม่ได้วัด", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "ตัวระบุตัวแปลงสัญญาณเสียง เป็น null เมื่อไม่มีการบันทึกตัวระบุ", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณ", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "คีย์เหล่านี้อธิบายออบเจ็กต์เฟรมแต่ละรายการ image_url มีเฉพาะ url ไม่ต้องระบุ frame_images สำหรับคำขอที่มีเฉพาะข้อความ", "content": "อาร์เรย์ของออบเจ็กต์เฟรม แต่ละออบเจ็กต์มี type=image_url, image_url ซึ่งมี url และ frame_type ใช้ URL ภาพ HTTPS และกำหนด frame_type เป็น first_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "ต้นทุนการสร้างโดยประมาณ", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "runway/gen-4.5", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" } ], "name": "Runway: Gen-4.5", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.48, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.48, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "credit_usd": "0.01", "credits_per_second": "12" }, "label": "Ultra", "units": [ { "amount": "0.24", "amount_unit": "usd_per_output_video_second", "conditions": { "credit_usd": "0.01", "credits_per_second": "12" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.40", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.24", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD_cent", "billing_original_rate": "24", "key": "cents_per_second_output", "label": "output second", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "runway/gen-4.5", "short": "Runway Gen-4.5 สร้างวิดีโอจากคำอธิบายฉากหรือภาพพร้อมทิศทางการเคลื่อนไหว คลิป 2–10 วินาที การกำกับกล้องชัดเจน และตัวเลือกองค์ประกอบแยกสำหรับข้อความสู่วิดีโอกับภาพสู่วิดีโอ เหมาะกับแนวคิดภาพยนตร์ B-roll และฉากภาพเคลื่อนไหว" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Runway Gen-4.5 สร้างวิดีโอจากคำอธิบายฉากหรือภาพพร้อมทิศทางการเคลื่อนไหว คลิป 2–10 วินาที การกำกับกล้องชัดเจน และตัวเลือกองค์ประกอบแยกสำหรับข้อความสู่วิดีโอกับภาพสู่วิดีโอ เหมาะกับแนวคิดภาพยนตร์ B-roll และฉากภาพเคลื่อนไหว", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "d2556067ff4183b04f3e1423e7c30ad2ee739f6938c796c428dd400b660fbe19", "raw_model_js_projection_sha256": "7fa0b826b736f2195ef9051e18c5155cdfb70ad0bed55500f5c2fd140ecd71b9", "raw_model_json_sha256": "d2556067ff4183b04f3e1423e7c30ad2ee739f6938c796c428dd400b660fbe19", "renderer_sha256": "890edb706fafafdd4f598bb324acf65fada58918b0911b97eb80e68be2ef65d9" }, "sourceRevision": "aab844f022ada2b87d735979416dc58b35fc46fa9fc8aef67336ca30db746c37" }