sangtao.ai
API key

Jobs

Xoá job

Xoá hẳn một job và các file kết quả của nó.

DELETEhttps://api.sangtao.ai/v2/jobs/{jobId}

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số đường dẫn

  • jobIdstringbắt buộc

    jobId trong đường dẫn.

Xoá là mất hẳn job và các file kết quả (ảnh, video) — link của chúng không mở được nữa. Không hoàn tác được.

Quyền của key

API key cần quyền Ghi (Write) cho Jobs. Key chỉ đọc nhận 403.

Mã lỗi

MãerrorCodeKhi nào
403FORBIDDENKey không có quyền ghi Jobs
404JOB_NOT_FOUNDKhông có job nào của bạn với jobId này
409JOB_PUBLISHEDJob đang công khai trong thư viện — gỡ công khai trước
DELETE/jobs/{jobId}
curl -X DELETE "https://api.sangtao.ai/v2/jobs/img-456" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "deleted": 1
  }
}