TOOL API

creative_image_edit_get

Edits an existing image from the Asset Library by cropping to a fixed size or applying creative trimming, then automatically uploads the edited result back to the Asset Library and returns the new image ID. This endpoint only supports cropping/trimming images that were previously uploaded to the Asset Library. Supported edit methods are `fix_size` (fixed width/height crop, no trimming), `only_gauss_pad` (Gaussian blur trimming only, no crop), and `gauss_padding_reserve_score` (Gaussian blur catch-all that adjusts the image based on the size of the main subject in the original image). To upload an image before editing, use `/file/image/ad/upload/`. Recommended source image resolution is at least 1200 × 628 px.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.creative_image_edit_get
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

advertiser_idrequired

Advertiser ID.

edit_method

Editing method. Supported values are `fix_size` (fixed width and height crop, no trimming), `only_gauss_pad` (Gaussian blur trimming only, no cropping), and `gauss_padding_reserve_score` (Gaussian blur catch-all that adjusts the image based on the size of the main subject in the original image). Default is `fix_size`.

heightrequired

Height of the edited image.

image_idrequired

Image ID of the source image to edit. The image must already exist in the Asset Library because this endpoint only edits previously uploaded Asset Library images.

image_name

Name for the edited image after processing. If omitted, a name is generated automatically.

widthrequired

Width of the edited image.