Skip to main content

​
Endpoint

POST https://openapi.akool.com/api/open/v4/image2Video/delbyids

​
Request Headers

ParameterValueDescription
x-api-keyAPI KeyYour API Key used for request authorization. If both Authorization and x-api-key have values, Authorization will be used first and x-api-key will be discarded.
AuthorizationBearer {token}Your API Key used for request authorization.Get Token

​
Body Attributes

ParameterTypeRequiredDescription
_idsStringtrueMultiple IDs separated by commas

​
Response Attributes

ParameterTypeDescription
codeIntegerInterface returns business status code (1000:success)
msgStringInterface returns status information
dataObjectResponse data object
- successIdsArraySuccessfully deleted video IDs
- noPermissionItemsArrayFailed deletion information list
— _idStringFailed deletion video ID
— msgStringFailure reason

​
Example

​
Request Body

{
  "_ids": "68919a464b4dbdd4ab3d3034,6891a07f5d612f78c9204f1c,6891a2295d612f78c9204f77"
}

​
Request

curl --location 'https://openapi.akool.com/api/open/v4/image2Video/delbyids' \
--header 'x-api-key: {{API Key}}' \
--header 'Content-Type: application/json' \
--data '{
  "_ids": "68919a464b4dbdd4ab3d3034,6891a07f5d612f78c9204f1c,6891a2295d612f78c9204f77"
}'

​
Response

{
  "code": 1000,
  "msg": "Delete successfully",
  "data": {
    "successIds": [
      "6882f4c10529ae771e71531d"
    ],
    "noPermissionItems": [
      {
        "_id": "6881cd86618fa41c89557b0c",
        "msg": "video resource is processing, please try again later"
      }
    ]
  }
}

​
Important Notes

  • You can delete multiple videos at once by separating IDs with commas
  • Videos that are currently processing (status = 2) cannot be deleted; wait until they complete or fail
  • You can only delete videos that belong to your account
  • The noPermissionItems array will contain details about any videos that could not be deleted
  • Deletion is permanent and cannot be undone