Tổng quan/OpenAPI/Edit và tiếp tục

Edit và tiếp tục

Đổi lại một sáng tạo hiện có hoặc tiếp tục nhiệm vụ nghỉ ngơi mới nhất của nó.

Edit nội dung hiện có

Explainer Video chấp nhận tin nhắn theo dõi bằng ngôn ngữ tự nhiên:

POST /creations/{id}/messages

Ví dụ :

{  "content": "Keep everything else and make the second scene easier for new employees",  "input_file_ids": [],  "idempotency_key": "video-edit-20260901-001"}

Một thông điệp có thể mô tả một thay đổi toàn bộ video hoặc tên một cảnh được chọn. KPainter lên kế hoạch phạm vi bị ảnh hưởng và tiếp tục sản xuất khi tài khoản và ngân sách cho phép.

AI Image và AI App hiện không quảng cáo cùng một dòng công việc chỉnh sửa trò chuyện. Tạo một kết quả mới khi các khả năng không thể hiện một con đường cải thiện được hỗ trợ.

Tiếp tục một nhiệm vụ nghỉ ngơi

Khi GET /creations/{id} trở lại nghỉ ngơi, kiểm tra các hoạt động sẵn có trước. Chỉ nộp một hành động trong danh sách này:

POST /creations/{id}/actions
{  "action": "resume_after_recharge",  "idempotency_key": "resume-20260901-001"}

Các hành động có thể bao gồm:

  • resume_after_recharge sau khi cân bằng là đủ
  • approve_overage sau khi người dùng chấp nhận ước tính được sửa đổi
  • Chỉ rút lui khi KPainter rõ ràng đánh dấu một rút lui an toàn

Bất lực và an toàn

  • Sử dụng lại cùng một IDpotency_key cho cùng một thông điệp hoặc hành động sau khi ngừng vận chuyển.
  • Đừng giữ nút khôi phục của một nhiệm vụ cũ hoạt động sau khi một nhiệm vụ mới bắt đầu.
  • Chỉ tiếp tục nhiệm vụ được nghỉ cuối cùng; dịch vụ xác nhận điều này một lần nữa.
  • Đừng phát minh ra một hành động khi các hành động có sẵn là trống rỗng.
  • Kiểm tra tình trạng trước khi rút lại yêu cầu từ xa không chắc chắn.
  • Chỉ gửi ID tạo tài liệu, hành động, và IDpotency key.

Thông điệp và hành động là không đồng bộ. Sau một 202 phản ứng, tiếp tục truy vấn GET /creations/{id}; làm mới kết quả chỉ sau khi một giao hàng có sẵn.