Làm video

Mỗi video bắt đầu với một cuộc gọi: POST /v1/render. Trang này giải thích các lựa chọn bạn thực hiện trong cuộc gọi đó. Đối với mỗi trường và giới hạn của nó, xem Tham chiếu Tạo kết xuất.

Bản tóm tắt hoặc sơ đồ cảnh

Gửi một cái này đi.

Một bản tóm tắt

brief là mô tả video bằng ngôn ngữ đơn giản, lên đến 4.000 ký tự. Reigniter lên kế hoạch cho các cảnh, viết lời dẫn và bắt đầu render.

{
  "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"
}

Các trường ảnh hưởng đến kế hoạch:

Lĩnh vực	Mặc định	Nó làm gì
`kind`	`ad`	`ad` quảng cáo, `training` video đào tạo.
`duration_sec`	20 cho `ad`, 60 cho `training`	Tổng độ dài mục tiêu, từ 5 đến 120 giây.
`narrator`	`true`	`false` làm một video không có lồng tiếng.
`brand_name`	không có	Tên thương hiệu mà người lập kế hoạch nên sử dụng.
`category`	không có	Danh mục sản phẩm, ví dụ như `coffee` hoặc `saas`.
`title`	viết cho bạn	Tiêu đề cho video.

Lập kế hoạch chi tiêu các khoản tín dụng. Nếu kế hoạch thất bại, bạn sẽ nhận được 502 PLAN_FAILED và các khoản tín dụng kế hoạch sẽ được hoàn lại. Nếu bạn gửi plan_notes lại cho ai đó, họ sẽ giải thích bất cứ điều gì mà người lập kế hoạch đã đánh dấu trong kế hoạch của họ.

Kế hoạch cảnh

Một scene_plan là danh sách riêng của bạn gồm từ 1 đến 12 cảnh, được dựng theo thứ tự như đã nêu. Hãy dùng nó khi bạn đã biết từng cảnh nên hiển thị và nói gì.

{
  "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" }
    }
  ]
}

Các loại cảnh:

`type`	Những gì nó hiển thị
`motion`	Văn bản động sắc nét, số, bước hoặc logo. Sử dụng cho bất cứ thứ gì cần đọc được.
`t2v_fast`	Đoạn phim được tạo ra về người, địa điểm hoặc vật thể từ `prompt`.
`i2v_fast`	Đoạn phim được tạo bắt đầu từ một hình ảnh: `ref_image_url` của cảnh, hoặc ảnh sản phẩm của bạn.
`s2v`	Một người dẫn chương trình nói chuyện với máy quay. Cần một khuôn mặt.
`walk_talk`	Một người dẫn chương trình đi lại và nói chuyện. Cần một khuôn mặt.
`footage`	Đoạn clip của bạn từ `video_url`, phát nguyên trạng.

Mỗi cảnh lấy một prompt (những gì máy quay nhìn thấy, hoặc bản sao trên màn hình cho motion) và một script tùy chọn (câu thoại của người dẫn chuyện). Danh sách đầy đủ các trường cảnh nằm trong phần tham khảo.

Thương hiệu

Một bản render API không bao giờ tự nhận ra một thương hiệu, ngay cả khi tài khoản của bạn có bộ kit thương hiệu. Bạn chọn thương hiệu trong mỗi yêu cầu:

brand_logo_url: logo của bạn, dưới dạng URL https công khai hoặc URI dữ liệu.
brand_colors: tùy chọn, tối đa 12 màu lục giác, chẳng hạn như ["#3B2416", "#F4E9DC"].

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

Nếu không có logo, video sẽ kết xuất mà không có logo và không có thẻ kết thúc. Để nói rõ ràng, hãy gửi brand_enabled: false.

Ảnh sản phẩm

product_image_url là ảnh sản phẩm của bạn (URL https công khai hoặc URI dữ liệu). Nó giữ sản phẩm giống nhau trong mọi cảnh, thay vì để người mẫu tự sáng tạo.

Một số định dạng bán sản phẩm và cần có ảnh. Nếu bạn đặt một route như vậy (ví dụ product-ad, unboxing, ugc-ad hoặc app-demo) và bản vẽ hiển thị sản phẩm, một bản render không có ảnh sẽ bị từ chối với 400 PRODUCT_IMAGE_REQUIRED. Để render mà không có ảnh một cách cố ý, hãy gửi product_enabled: false.

Người dẫn chương trình

Các cảnh s2v và walk_talk cho thấy một người đang nói. Họ cần một khuôn mặt: avatar_preset_id cho toàn bộ video, hoặc ref_image_url có mặt tại cảnh. Một kế hoạch có cảnh nói chuyện và không có khuôn mặt sẽ bị từ chối với 400 PRESENTER_REQUIRED. Để Reigniter sử dụng người dẫn chương trình có sẵn, hãy gửi presenter_enabled: false.

Không có gì làm điểm nhấn cho video

Khi bạn đặt một route mà không gửi thương hiệu, không có ảnh sản phẩm và không có người thuyết trình, và kế hoạch sẽ tạo ra tất cả hình ảnh, thì việc render sẽ bị từ chối 422 NO_ANCHOR. Nếu không có điểm neo, người mẫu sẽ sáng tạo ra sản phẩm và con người, và họ sẽ không phù hợp với thương hiệu của bạn.

Thêm một trong ba cái đó, hoặc gửi product_enabled: false hoặc presenter_enabled: false để render bất cứ lúc nào.

Hình thức và âm thanh

Lĩnh vực	Giá trị	Mặc định
`aspect`	`9:16`, `16:9`, `1:1`, `4:5`, `4:3`, `3:4`	`9:16`
`quality`	`draft`, `standard`, `premium`	`draft`
`language`	một mã ngôn ngữ, như `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`	được thiết lập bởi định dạng
`voice_preset_id`	ID giọng nói của người dẫn chuyện	một giọng mặc định
`upscale`	`true` hay `false`	được thiết lập bởi định dạng và chất lượng

quality cao hơn và upscale tốn nhiều tín chỉ hơn và mất nhiều thời gian hơn.

Video đào tạo

Đặt kind: "training" với brief để lên kế hoạch cho video đào tạo thay vì quảng cáo. Người lập kế hoạch viết các bước và tóm tắt, đồng thời sử dụng motion cảnh để hướng dẫn trên màn hình.

{
  "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"
}

Thử lại và tính bất lực

Gửi một tiêu đề Idempotency-Key với giá trị duy nhất, chẳng hạn như UUID, cho mỗi lần kết xuất. Nếu yêu cầu của bạn hết thời gian và bạn thử lại với cùng một khóa, Reigniter từ chối lặp lại và không hiển thị hoặc tính phí lần thứ hai.

Việc lặp lại bị từ chối, nên không trả về job_id gốc. Lưu job_id từ phản hồi đầu tiên bất cứ khi nào bạn nhận được phản hồi.
Với scene_plan, phép lặp trả về 409 DUPLICATE_REQUEST.
Với một brief, sự lặp lại có thể trả về 402 với thông điệp This request was already submitted. Coi nó giống như một 409.
Sử dụng một khóa mới cho mỗi video mới. Dùng lại một khóa cho một video khác sẽ từ chối video đó.

Nếu không có header, mỗi cuộc gọi là một render mới và một charge mới.

Dấu chìm

Phản hồi render có trường watermarked. Video làm trên gói Agency không có watermark.

Sản lượng

Khi công việc thành công, video_url trên GET /v1/job/{id} sẽ có liên kết trực tiếp đến MP4. Tải về và giữ bản sao của riêng bạn.