Lịch sử: Wandura C1.1: video quảng cáo từ một đoạn mô tả

Mọi lần sửa trang này, mới nhất ở trên. Mở từng mục để xem đã đổi gì.

← Wandura C1.1: video quảng cáo từ một đoạn mô tả

19/10/2026 · +3 −3 dòng

Xem thay đổi

⋯
  | Mô tả | Tối đa 4000 ký tự |
  | Số kết quả | Một video mỗi job |
- | Thời gian tối đa của job | 960 giây (16 phút) tính từ lúc gửi, ở làn `priority`. Job chưa xong lúc đó kết thúc `timeout`, không tính tiền. Hãy gửi lại. |
+ | Thời gian tối đa của job | 1080 giây (18 phút) tính từ lúc gửi, ở làn `priority`. Job chưa xong lúc đó kết thúc `timeout`, không tính tiền. Hãy gửi lại. |
  | Trần chi tiêu mỗi ngày | Admin của org đặt cho từng product. Vượt trần: `429 DAILY_CAP_REACHED` (xem [Lỗi](#errors)). |
  | Mỗi người dùng cuối | Mặc định 20 job mỗi ngày, chỉ khi bạn gửi `end_user_id` (`429 END_USER_LIMIT_REACHED`). |
⋯
  ## Làm lại từ một quảng cáo gốc {#remake}
  
- **Đang triển khai.** Gửi một quảng cáo có sẵn qua `video_url` để nhận một quảng cáo mới giữ nguyên các cảnh và nhịp, với người và sản phẩm của bạn. Trước khi tính năng này lên `api.wandura.ai`, `video_url` bị từ chối bằng `422`.
+ Gửi một quảng cáo có sẵn qua `video_url` để nhận một quảng cáo mới giữ nguyên các cảnh và nhịp, với người và sản phẩm của bạn.
  
  ```bash
⋯
  - **Giá**: theo giá mỗi giây ở trên. Đọc quảng cáo gốc không tính thêm tiền. Tiền giữ tính theo `duration`, nên theo độ dài quảng cáo gốc khi bạn không gửi `duration`.
  - **Kiểm trước khi giữ tiền**: `video_url` không phải MP4 hay MOV đọc được, hoặc dài hơn 60 giây, nhận `422 INVALID_INPUT` và không bị giữ tiền. Giữ link còn hạn ít nhất 30 phút, vì file được tải lại khi job chạy.
- - **Thời gian tối đa của job**: 1080 giây (18 phút) tính từ lúc gửi, ở làn `priority`, hơn mức ở trên 2 phút để đọc quảng cáo gốc.
+ - **Thời gian tối đa của job**: 1080 giây (18 phút) tính từ lúc gửi, ở làn `priority`, như ở trên.
  - **Kết thúc không có video, không tính tiền**: quảng cáo gốc có nội dung người lớn, bạo lực, thù ghét hoặc nguy hiểm kết thúc `failed` với `CONTENT_MODERATION_BLOCKED`. Link không còn trả về video dài tối đa 60 giây lúc job chạy kết thúc với `INPUT_UNUSABLE`. Máy chủ giữ quảng cáo gốc đang bận thì kết thúc với `GENERATION_FAILED` (thử lại được).
  
⋯

19/10/2026 · +40 −4 dòng

Xem thay đổi

⋯
  > **TL;DR**: gọi `POST /v2/jobs` với `model: "wandura-c1-1"`, một `prompt` mô tả quảng cáo và tối đa 4 ảnh tham chiếu. Bạn nhận về một video hoàn chỉnh dài 5 đến 60 giây. Wandura tự lên các cảnh quay, dựng từng cảnh rồi nối lại; bạn không cần viết system prompt. Giá tính theo giây video đầu ra: 480p $0,09, 720p $0,15, 1080p $0,30. Poll `GET /v2/jobs/{job_id}` hoặc nhận webhook có ký, giống hệt các job video khác. Job lỗi, bị chặn hoặc quá giờ thì không tính tiền.
  
- **Đang triển khai.** Wandura C1.1 đang được đưa lên `api.wandura.ai`. Trước khi lên đó, `model: "wandura-c1-1"` bị từ chối bằng `422`.
- 
  ## Cơ bản {#basics}
  
⋯
  Job kết thúc mà không có video không phải lỗi HTTP. `error.code` của nó là `GENERATION_FAILED` (thử lại được), `CONTENT_MODERATION_BLOCKED` (đổi mô tả hoặc ảnh) hoặc `TIMEOUT` (gửi lại). Cả ba đều không tính tiền. Xem [Trạng thái](jobs.md#statuses).
  
- ## Làm lại từ một quảng cáo gốc (sắp có) {#remake}
+ ## Làm lại từ một quảng cáo gốc {#remake}
  
- **Sắp có.** Bạn sẽ gửi được một video quảng cáo có sẵn qua `video_url`, kèm ảnh và mô tả của bạn nếu muốn, để nhận một video mới dựng lại từ nó. Wandura chỉ đọc mỗi quảng cáo gốc một lần rồi dùng lại kết quả đọc đó cho các lần làm lại sau với cùng quảng cáo. Trước khi có, `video_url` bị từ chối bằng `422`.
+ **Đang triển khai.** Gửi một quảng cáo có sẵn qua `video_url` để nhận một quảng cáo mới giữ nguyên các cảnh và nhịp, với người và sản phẩm của bạn. Trước khi tính năng này lên `api.wandura.ai`, `video_url` bị từ chối bằng `422`.
+ 
+ ```bash
+ curl -X POST https://api.wandura.ai/v2/jobs \
+   -H "Authorization: Bearer $WANDURA_KEY" \
+   -H "Content-Type: application/json" \
+   -H "Idempotency-Key: remake-2026-10-20-001" \
+   -d '{
+     "model": "wandura-c1-1",
+     "video_url": "https://your-bucket.example.com/ads/source-ad.mp4",
+     "prompt": "Remake it for Lumi sparkling water: a summer sale at a Lumi drinks store. The woman in Image 1 is the shop assistant.",
+     "image_urls": ["https://your-bucket.example.com/ads/woman.jpg"],
+     "resolution": "720p",
+     "aspect_ratio": "16:9"
+   }'
+ # HTTP 202
+ # {"job_id":"run_Pz81KqTmV2Rc","status":"queued","model":"wandura-c1-1","created_at":"2026-10-20T05:14:46.251Z"}
+ ```
+ 
+ | Field | Ghi chú |
+ |---|---|
+ | `video_url` | Quảng cáo gốc: file MP4 hoặc MOV dài tối đa 60 giây, ở URL https công khai. Presigned URL và URL kết quả của Wandura đều dùng được. |
+ | `prompt` | Không bắt buộc khi có `video_url`: điều cần đổi, ví dụ sản phẩm, thương hiệu, thông điệp hay ngôn ngữ của bạn. Không gửi thì quảng cáo được làm lại y như cũ, với người mới và một sản phẩm chung chung. |
+ | `image_urls` | Không bắt buộc, tối đa 4: người, sản phẩm và bối cảnh muốn đưa vào. |
+ | `duration` | Không bắt buộc. Mặc định: độ dài của quảng cáo gốc, từ 5 đến 60 giây (quảng cáo gốc ngắn hơn 5 giây thì được 5 giây). |
+ 
+ - **Giữ lại**: các cảnh theo đúng thứ tự, thời lượng co giãn theo độ dài mới, cách quay và chuyển động máy, nhịp, nhạc và âm thanh, cùng dáng của lời thoại và chữ trên hình. **Thay đổi**: người (lấy từ ảnh của bạn, hoặc người mới), sản phẩm và thương hiệu (lấy từ prompt của bạn, hoặc một sản phẩm chung chung), và lời thoại được viết lại cho sản phẩm của bạn. Thương hiệu, logo và người thật trong quảng cáo gốc không bị chép lại.
+ - **Chỉ đọc một lần**: Wandura đọc mỗi quảng cáo gốc một lần rồi dùng lại kết quả đọc cho mọi lần làm lại sau với cùng file video đó, dù gửi từ link nào hay tải lên lại. Một video làm lại của Wandura C1.1 gửi lại qua `video_url` dùng lại kết quả đọc của quảng cáo gốc ban đầu. Kết quả đọc chỉ mô tả quảng cáo gốc, không bao giờ chứa prompt, ảnh hay thương hiệu của bạn.
+ - **Giá**: theo giá mỗi giây ở trên. Đọc quảng cáo gốc không tính thêm tiền. Tiền giữ tính theo `duration`, nên theo độ dài quảng cáo gốc khi bạn không gửi `duration`.
+ - **Kiểm trước khi giữ tiền**: `video_url` không phải MP4 hay MOV đọc được, hoặc dài hơn 60 giây, nhận `422 INVALID_INPUT` và không bị giữ tiền. Giữ link còn hạn ít nhất 30 phút, vì file được tải lại khi job chạy.
+ - **Thời gian tối đa của job**: 1080 giây (18 phút) tính từ lúc gửi, ở làn `priority`, hơn mức ở trên 2 phút để đọc quảng cáo gốc.
+ - **Kết thúc không có video, không tính tiền**: quảng cáo gốc có nội dung người lớn, bạo lực, thù ghét hoặc nguy hiểm kết thúc `failed` với `CONTENT_MODERATION_BLOCKED`. Link không còn trả về video dài tối đa 60 giây lúc job chạy kết thúc với `INPUT_UNUSABLE`. Máy chủ giữ quảng cáo gốc đang bận thì kết thúc với `GENERATION_FAILED` (thử lại được).
+ 
+ ```json
+ HTTP 422
+ {"error":{"code":"INVALID_INPUT","message":"Validation failed.","retryable":false,"details":[
+   {"field":"video_url","reason":"the source ad lasts 75 s; at most 60 s"}],
+  "docs_url":"https://docs.wandura.ai/developers/api-v2/errors#jobs-invalid-input"}}
+ ```

19/10/2026 · Tạo trang