TOOL API

file_image_ad_upload

Uploads an image to the Asset Library and returns an image ID for ad creation. Request timeout is 10 seconds, and upload speed depends on network bandwidth, so keep file sizes reasonable. This endpoint can be used for standard ad image assets and, if the uploaded asset qualifies, for Carousel Ads.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

file_id

Required when `upload_type` is `UPLOAD_BY_FILE_ID`. ID of an image file already uploaded to the file repository.

file_name

Image name. Length limit: 1-100 characters. If omitted, the default is the original file name; if the final file name exceeds 100 characters, it is truncated. Under the same `advertiser_id`, file names must be unique. You can call `/file/name/check/` to verify whether the name has already been used. If you get a duplicate file name error, rename the file or append a timestamp such as `<original_filename>_<timestamp>` and upload again.

image_url

Required when `upload_type` is `UPLOAD_BY_URL`. Public URL of the image to upload, for example `http://xxx.xxx`.

upload_typerequired

Image upload method. When `UPLOAD_BY_URL`, you must provide `image_url`. When `UPLOAD_BY_FILE_ID`, you must provide `file_id`.