Download

Download history of generated images by image ID.

This endpoint retrieves the download history for images generated by different applications based on the provided image ID. It supports multiple app types including face swap, super resolution, and editing processes.

Args: args (dict): Dictionary containing request parameters:

  • id_image (str): The unique identifier of the image
  • app (str): Application type identifier. Defaults to 'random', 'keep', 'swap', 'superid', 'edit', 'edit_fill', 'edit_background', or 'expand'.

Returns: dict: Response containing:

  • history (list): List of image download links/data
  • info_list (list): List of metadata information for each image For app_id=6 (super resolution): Contains scale factor, prompt, guidance scale, prompt strength, HDR, controlnet conditioning scale, denoise, and mode For other apps: May contain different metadata structures Raises: HTTPError:
  • 405: If image ID is not provided or invalid
  • 405: If app parameter is not valid
  • 405: If image ID is not valid or expired for the user Notes:
  • Requires user authentication via token
  • Access to high-quality content may be restricted based on user subscription status
  • For non-paying users, high-quality swap data links are removed
  • Different app types return different metadata structures in info_list

Authentication: Required (Token-based)

POST
/api/history
AuthorizationBearer <token>

In: header

id_image?string
app?string

Response Body

Examples

curl -X POST "https://api.piktid.com/api/history" \
  -H "Content-Type: application/json" \
  -d '{}'
Empty
Empty
Empty