การสร้างวิดีโอ

วิดีโอทุกตัวเริ่มต้นด้วยการเรียกหนึ่งครั้ง: POST /v1/render หน้านี้อธิบายตัวเลือกที่คุณทําในการเรียกนั้นสําหรับแต่ละฟิลด์และขีดจํากัดของมัน ดูที่ การอ้างอิง สร้างการเรนเดอร์

แผนผังบรีฟหรือแผนฉาก

ส่ง อัน นี้มา

สรุปสั้น ๆ

brief คือคําอธิบายวิดีโอแบบภาษาง่าย ๆ สูงสุด 4,000 ตัวอักษรReigniter วางแผนฉาก เขียนคําบรรยาย และเริ่มการเรนเดอร์

{
  "brief": "A 30 second advert for Northwind Coffee's weekly subscription. Show the beans, the roasting, and a happy customer opening the box.",
  "kind": "ad",
  "duration_sec": 30,
  "brand_name": "Northwind Coffee",
  "category": "coffee"
}

ฟิลด์ที่กําหนดแผนงาน:

สนาม	ค่าเริ่มต้น	สิ่งที่มันทํา
`kind`	`ad`	`ad` โฆษณา `training` วิดีโอฝึกอบรม
`duration_sec`	20 `ad`, 60 `training`	เป้าหมายความยาวรวม 5 ถึง 120 วินาที
`narrator`	`true`	`false` ทําวิดีโอโดยไม่มีเสียงบรรยาย
`brand_name`	ไม่มี	ชื่อแบรนด์ที่ผู้วางแผนควรใช้
`category`	ไม่มี	หมวดหมู่สินค้า เช่น `coffee` หรือ `saas`
`title`	เขียนขึ้นเพื่อคุณ	ชื่อเรื่องของวิดีโอ

ฝ่ายวางแผนใช้เครดิตถ้าการวางแผนล้มเหลว คุณจะได้รับ 502 PLAN_FAILED และเครดิตการวางแผนจะคืนถ้าคุณส่ง plan_notes กลับไปยังบุคคล พวกเขาจะอธิบายทุกอย่างที่ผู้วางแผนระบุไว้ในแผนของตัวเอง

แผนผังฉาก

scene_plan คือรายการของคุณเองที่มีฉาก 1 ถึง 12 ฉาก เรนเดอร์ตามลําดับที่กําหนดไว้ใช้มันเมื่อคุณรู้แล้วว่าฉากแต่ละฉากควรแสดงและพูดอะไร

{
  "title": "Northwind launch",
  "scene_plan": [
    {
      "type": "motion",
      "role": "hook",
      "prompt": "Fresh coffee, delivered weekly",
      "script": "Fresh coffee, delivered every week.",
      "motion": { "beat": "hook" }
    },
    {
      "type": "t2v_fast",
      "role": "body",
      "prompt": "Slow close-up of coffee beans tumbling out of a kraft paper bag onto a wooden table, soft morning light",
      "script": "Roasted in small batches, a few days before it reaches you."
    },
    {
      "type": "motion",
      "role": "cta",
      "prompt": "Order at northwind.example",
      "script": "Order today.",
      "motion": { "beat": "cta" }
    }
  ]
}

ประเภทของฉาก:

`type`	สิ่งที่มันแสดงผล
`motion`	ข้อความเคลื่อนไหวที่คมชัด ตัวเลข ขั้นตอน หรือโลโก้ใช้สําหรับสิ่งที่ต้องการให้อ่านได้
`t2v_fast`	ฟุตเทจที่สร้างขึ้นของผู้คน สถานที่ หรือวัตถุ จาก `prompt`
`i2v_fast`	ฟุตเทจที่สร้างขึ้นซึ่งเริ่มต้นจากภาพ: `ref_image_url` ของฉาก หรือภาพสินค้าของคุณ
`s2v`	พิธีกรพูดกับกล้องต้องมีหน้า
`walk_talk`	พิธีกรเดินและพูดต้องมีหน้า
`footage`	คลิปของคุณเองจาก `video_url` เล่นตามสภาพ

แต่ละฉากจะ prompt (สิ่งที่กล้องเห็น หรือสําเนาบนหน้าจอสําหรับ motion) และ script เสริม (บรรทัดของผู้บรรยาย)รายการฟิลด์ฉากทั้งหมดอยู่ในเอกสารอ้างอิง

แบรนด์

เรนเดอร์ API จะไม่ เลือกแบรนด์เพียงอย่างเดียว แม้ว่าบัญชีของคุณจะมีชุดแบรนด์ก็ตามคุณเลือกแบรนด์ในแต่ละคําขอ:

brand_logo_url: โลโก้ของคุณ เป็น URL สาธารณะ https หรือ URI ข้อมูล
brand_colors: เลือกได้สูงสุด 12 สีหกเหลี่ยม เช่น ["#3B2416", "#F4E9DC"]

{
  "brief": "A 20 second advert for Northwind Coffee.",
  "brand_logo_url": "https://example.com/northwind-logo.png",
  "brand_colors": ["#3B2416", "#F4E9DC"]
}

ถ้าไม่มีโลโก้ วิดีโอจะเรนเดอร์โดยไม่มีโลโก้และไม่มีการ์ดท้ายเพื่อจะบอกอย่างชัดเจน ส่ง brand_enabled: false

ภาพสินค้า

product_image_url คือรูปภาพของสินค้าของคุณ (URL สาธารณะของ https หรือ URI ข้อมูล)มันทําให้สินค้าเหมือนกันในทุกฉาก แทนที่จะปล่อยให้โมเดลสร้างเอง

บางรูปแบบขายสินค้าและต้องการรูปภาพถ้าคุณตั้ง route แบบนั้น (เช่น product-ad, unboxing, ugc-ad หรือ app-demo) และแผนแสดงสินค้า การเรนเดอร์ที่ไม่มีรูปภาพจะถูกปฏิเสธด้วย 400 PRODUCT_IMAGE_REQUIRED หากต้องการเรนเดอร์โดยไม่มีรูปภาพโดยเจตนา ให้ส่ง product_enabled: false

ผู้ดําเนินรายการ

ฉาก s2v และ walk_talk แสดงให้เห็นคนพูดพวกเขาต้องมีใบหน้า: avatar_preset_idสําหรับทั้งวิดีโอ หรือ ref_image_url ในฉากแผนที่มีฉากพูดแต่ไม่มีหน้าจะถูกปฏิเสธด้วย 400 PRESENTER_REQUIRED เพื่อให้Reigniter ใช้พิธีกรสต็อก ให้ส่ง presenter_enabled: false

ไม่มีอะไรเป็นจุดยึดของวิดีโอ

เมื่อคุณตั้ง route แล้วไม่ส่งแบรนด์ ไม่มีรูปสินค้า ไม่มีผู้นําเสนอ และแผนจะสร้างภาพทั้งหมด การเรนเดอร์จะถูกปฏิเสธด้วย 422 NO_ANCHORถ้าไม่มีจุดยึด นางแบบจะสร้างสินค้าและคน และพวกเขาจะไม่เข้ากับแบรนด์ของคุณ

เพิ่มหนึ่งในสามตัวนี้ หรือส่ง product_enabled: false หรือ presenter_enabled: false ไปเรนเดอร์อยู่ดี

รูปลักษณ์และเสียง

สนาม	ค่านิยม	ค่าเริ่มต้น
`aspect`	`9:16`, `16:9`, `1:1`, `4:5`, `4:3`, `3:4`	`9:16`
`quality`	`draft`, `standard`, `premium`	`draft`
`language`	รหัสภาษา เช่น `en`, `fr`, `de`	`en`
`art_style`	`cinematic`, `stop_motion`, `mascot`, `watercolour`, `whimsy_3d`	`cinematic`
`music_style`	`upbeat-tech`, `cinematic-epic`, `lo-fi-chill`, `corporate-pop`	ตั้งค่าโดยรูปแบบ
`voice_preset_id`	รหัสเสียงผู้บรรยาย	เสียงเริ่มต้น
`upscale`	`true` หรือ `false`	ตั้งค่าโดยรูปแบบและคุณภาพ

qualityสูงและ upscaleต้องเรียนเครดิตมากขึ้นและใช้เวลานานขึ้น

วิดีโอฝึกอบรม

ตั้งค่า kind: "training" ด้วย brief เพื่อวางแผนวิดีโอฝึกอบรมแทนโฆษณาผู้วางแผนจะเขียนขั้นตอนและสรุป และใช้ฉาก motion สําหรับคําแนะนําบนหน้าจอ

{
  "brief": "How to reset a password in the Acme admin panel. Three steps, then a recap.",
  "kind": "training",
  "duration_sec": 60,
  "aspect": "16:9",
  "brand_logo_url": "https://example.com/acme-logo.png"
}

การทดลองใหม่และไอเดมโพเทนต์

ส่ง Idempotency-Key header ที่มีค่าเฉพาะ เช่น UUID ในทุกการเรนเดอร์หากคําขอของคุณหมดเวลาและคุณลองใหม่ด้วยคีย์ เดิม Reigniter จะปฏิเสธการทําซ้ําและไม่เรนเดอร์หรือชาร์จซ้ําอีกครั้ง

การซ้ําจะถูกปฏิเสธ จึงไม่คืน job_id เดิมบันทึก job_id จากการตอบกลับครั้งแรกเมื่อได้รับคําตอบ
เมื่อมี scene_plan, การซ้ําจะคืนค่า 409 DUPLICATE_REQUEST.
ด้วย brief, การซ้ําสามารถส่งคืน 402 พร้อมข้อความ This request was already submitted ปฏิบัติเหมือนกับ 409
ใช้คีย์ ใหม่ สําหรับวิดีโอใหม่แต่ละคลิปการใช้คีย์ซ้ําสําหรับวิดีโออื่นจะทําให้วิดีโอนั้นถูกปฏิเสธ

ถ้าไม่มีส่วนหัว ทุกการเรียกจะเป็นการเรนเดอร์ใหม่และการชาร์จใหม่

ลายน้ํา

การตอบสนองแบบเรนเดอร์มีช่อง watermarked วิดีโอที่สร้างบนแผน Agency จะไม่มีลายน้ํา

ผลลัพธ์

เมื่องานสําเร็จ video_url on GET /v1/job/{id} จะมีลิงก์ตรงไปยัง MP4ดาวน์โหลดและเก็บสําเนาของคุณเองไว้