AiVideoEditor
Bắt đầu miễn phí
Trình đơn

Đã xem lại 2026-11-11 · Phiên bản API 2026-11-09 · Đọc Markdown

Đăng bài và lên lịch

Một bài đăng của AiVideoEditor có một bản nháp được phiên bản hóa và các lượt gửi độc lập cho các tài khoản đã chọn. Việc lưu bản nháp khá nới lỏng; lưu thành công không xác nhận rằng mọi điểm đến đều có thể đăng.

Chuẩn bị bài đăng

  1. Đọc /api/v1/accounts và /api/v1/capabilities bằng khóa dự định dùng.
  2. Tải lên và hoàn tất mọi media cần thiết.
  3. Tạo bản nháp bằng POST /api/v1/posts, hoặc chỉnh sửa bằng PATCH /api/v1/posts/{id}. Cung cấp expectedVersion hiện tại khi chỉnh sửa và giữ lại phiên bản được trả về.
  4. Đặt định dạng điểm đến và các ghi đè biến thể theo từng tài khoản rõ ràng khi cần. Tài liệu tham khảo API định nghĩa các trường yêu cầu.
  5. Xác thực bằng POST /api/v1/posts/{id}/validate. HTTP 200 có thể chứa valid: false; kiểm tra mọi vấn đề trước khi gửi. Tài khoản không hợp lệ không bị loại khỏi đối tượng đích một cách lặng lẽ.

Đăng ngay hoặc sau

POST /posts/{id}/publish gửi bản nháp hiện tại. POST /posts/{id}/schedule yêu cầu scheduledAt, timezone và expectedVersion. Thời điểm lên lịch phải nằm trong tương lai và trong 90 ngày. Lưu dấu thời gian UTC ISO và một múi giờ hiển thị IANA riêng; giải quyết các sự nhập nhàng giờ mùa hè trước khi gửi.

Dùng một Idempotency-Key riêng biệt cho mỗi thao tác thay đổi mới. Giữ lại khóa và nội dung yêu cầu chính xác trước khi gửi. Sau khi hết thời gian chờ, phát lại yêu cầu giống hệt với cùng khóa đó. Chỉ đổi khóa khi bạn có ý định yêu cầu một thao tác mới. Việc chỉnh sửa hoặc lên lịch bản nháp lỗi thời sẽ trả về revision_conflict; đọc lại và xem xét nội dung mới nhất thay vì ghi đè một cách mù quáng.

Phản hồi 202 nghĩa là đã chấp nhận để gửi đi. Nó không phải bằng chứng đã đăng. Ghi lại các ID gửi đi và quan sát GET /posts/{id} hoặc webhook của khách hàng đã ký. Dùng polling có giới hạn với độ trễ tăng dần; dừng khi có kết quả cuối cùng hoặc cần chuyển giao cho con người thay vì lặp vô hạn.

Kết quả theo từng điểm đến

Các lượt gửi có thể kết thúc độc lập. Một điểm đến có thể đăng được trong khi điểm đến khác cần kết nối lại hoặc cần sự đồng ý. Hiển thị từng trạng thái và liên kết bài đăng gốc khi có. Chỉ thử lại một thất bại đã biết đủ điều kiện bằng POST /deliveries/{id}/retry. Không được tạo lại các điểm đến thành công để khôi phục điểm đến thất bại. Một kết quả bên ngoài không rõ cần đối chiếu hoặc xem xét, không phải gửi mới.

Hủy bằng POST /deliveries/{id}/cancel trong khi công việc vẫn chưa được nhận an toàn. too_late_to_cancel nghĩa là việc gửi đã tiến xa hơn ngưỡng hủy an toàn; nó không có nghĩa là bài đăng bên ngoài đã bị gỡ.

Xem xét của con người trên TikTok

Đọc /accounts/{id}/tiktok/settings để biết cài đặt creator hiện tại và các lựa chọn quyền riêng tư khả dụng. Đọc cài đặt hoặc lưu bản nháp không cung cấp sự đồng ý. consent_required bao gồm một cơ chế chuyển giao requiresAction an toàn đến trình soạn thảo đã xác thực. Một người có thẩm quyền xem xét chính xác video, chú thích và điểm đến và xác nhận rõ ràng các lựa chọn bắt buộc tại đó. Khóa sản phẩm và công cụ MCP không thể xác nhận thay họ. Thay đổi nội dung hoặc định danh đòi hỏi xem xét lại. Cơ chế chuyển giao tự nó không cấp tư cách thành viên hay quyền truy cập.

Các điều khiển trong trình soạn thảo

Dùng Add media để tải lên một tệp hoặc chọn một mục thư viện có sẵn. Chú thích được chia sẻ cho đến khi Customize content tạo một biến thể riêng cho tài khoản. Công cụ emoji và hashtag chèn văn bản thường tại con trỏ.

Posting options nhóm các cài đặt của tài khoản đã chọn. Các lựa chọn bắt buộc luôn hiển thị; các nhóm tùy chọn vẫn bị thu gọn. Thay đổi chỉ áp dụng cho tài khoản đó. Preview hiển thị bản nháp hiệu lực mà không lưu hay gửi nó, kể cả các bản nháp chưa hoàn chỉnh; cách trình bày của nền tảng gốc có thể khác.

Dùng tham chiếu tài sản riêng tư cho ảnh bìa và ảnh thu nhỏ đã lên lịch. Các phương án thay thế dùng URL công khai phải còn truy cập được tại thời điểm gửi. Nội dung phụ đề được lưu cùng cài đặt bất biến thay vì phụ thuộc vào một tệp cục bộ tạm thời. Tải lên tài liệu LinkedIn hiện chấp nhận PDF; các định dạng Office vẫn bị hạn chế cho đến khi xác thực chữ ký được triển khai.

Xem tài liệu tham khảo khả năng để biết các điều khiển chuẩn và giới hạn tích hợp. Hành vi định dạng và xác nhận mới đòi hỏi các migration cơ sở dữ liệu tương ứng trước khi triển khai.