Tham khảo công cụ

Bạn hiếm khi gọi tên chúng: hỏi một cách đơn giản và trợ lý của bạn sẽ chọn công cụ. Các công cụ giúp video tiêu tiền tín dụng và trả về job_id; video sẽ hiển thị ở nền và get_job_status báo cho bạn khi nào đã sẵn sàng.

create_ad

Một quảng cáo nhiều cảnh từ một bản tóm tắt, qua toàn bộ quy trình Studio: nó lên kế hoạch cho các cảnh, rồi dựng chúng.

Đầu vào
`brief`	bắt buộc	Mục đích của nó: sản phẩm, khán giả, góc nhìn, tâm trạng (3-2.000 ký tự).
`scene_count`	tùy chọn	2-6 cảnh, mặc định là 4.
`aspect`	tùy chọn	`16:9` (mặc định), `9:16` cho Reels, TikTok và Shorts, hoặc `1:1`.
`branded`	tùy chọn	`true` áp dụng bộ công cụ thương hiệu đã lưu trên tài khoản của bạn: logo, màu sắc và thẻ cuối. Nếu bạn không có, cuộc gọi sẽ dừng trước khi sạc bất cứ thứ gì.
`product_image_url`	tùy chọn	Hình ảnh công khai của sản phẩm sẽ được giới thiệu.
`title`, `idempotency_key`	tùy chọn

Chi phí: 1 tín dụng cho kế hoạch, sau đó là kết xuất. Nếu kết xuất không thể bắt đầu, khoản tín dụng lập kế hoạch sẽ được hoàn lại. Thử: “Tạo quảng cáo dọc 4 cảnh cho latte sữa yến mạch của chúng tôi, ấm áp và dễ chịu, với thương hiệu của tôi.”

create_presenter_video

Người thuyết trình sẽ đọc kịch bản của bạn trước máy quay. Chi phí: tính theo độ dài kịch bản, hiển thị trong phần trả lời là credits_charged.

Đầu vào
`script`	bắt buộc	Chính xác từ (5-2.000 ký tự).
`title`, `idempotency_key`	tùy chọn

Thử: “Làm một video cho người thuyết trình với nội dung: Chào mừng bạn đến với đội ngũ, đây là cách đặt ca làm đầu tiên của bạn.”

create_launch_video

Quảng bá ngắn cho người dẫn chương trình cho một ứng dụng hoặc sản phẩm; kịch bản được viết cho bạn và trả lại cùng với công việc. Chi phí: tính theo độ dài kịch bản.

Đầu vào
`app_name`, `description`	bắt buộc	Tên gọi, công việc và dành cho ai.
`website_url`, `idempotency_key`	tùy chọn

Thử: “Làm video ra mắt cho Northwind, một ứng dụng lập ngân sách dành cho freelancer.”

get_job_status

Miễn phí. Trả về status (queued, processing, completed hoặc failed), progress 0-100, và video_url sau khi hoàn thành. Việc render thường mất vài phút; render thất bại sẽ hoàn lại số tiền đã tính. Chỉ các job trên tài khoản của bạn mới hiển thị.

get_account

Miễn phí. Tên, email, gói cước và các khoản tín dụng còn lại, và can_create: liệu tài khoản này có thể tạo từ trợ lý hay không.