Post Shoppable Video and Photos APIs v202607: New Fields Added

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 · 2026-09-06 12:43:24

当前资料结构化阅读页
固定快照已留存，可追溯
官方原文可核对

查看技术与溯源信息

平台 / profile: TikTok Shop / profile.tiktok.docs_api
语言: en-US
发布版本: cn-20260909-2
标签: zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Summary

Post Shoppable Video API v202607 adds a new request field, video_info.is_ai_generated, to indicate whether the submitted video content is AI generated. When this field is set to true, the published post will display an AI generated label. Post Shoppable Video API and Post Shoppable Photos API also add a new response field, quota, to return the creator's content posting quota when quota restrictions apply.

§2 What is changing

The following fields are added in v202607.

API	Location	Field	Type	Required / Returned	Description
Post Shoppable Video	Request body: `video_info`	`is_ai_generated`	`bool`	No	Indicates whether the submitted video content is AI generated. If set to `true`, the post will display an AI generated label.
Post Shoppable Video	Response body: `data.video`	`quota`	`string`	Returned on successful publish when applicable; omitted if no quota restriction applies	Content posting quota for the creator. Returned on successful publish; included in the error message on failure; omitted if no quota restriction applies.
Post Shoppable Photos	Response body: published photo information	`quota`	`string`	Returned on successful publish when applicable; omitted if no quota restriction applies	Content posting quota for the creator. Returned on successful publish; included in the error message on failure; omitted if no quota restriction applies.

§3 Request body update

Request body update

{
  "video_info": {
    "file_id": "your_video_file_id",
    "title": "your video caption",
    "cover_uri": "your_cover_uri",
    "cover_timestamp_ms": 1000,
    "music_id": "your_music_id",
    "is_ai_generated": true
  },
  "product_link_info": {
    "product_id": "your_product_id",
    "title": "your product anchor title"
  }
}

§4 Response body update

Response body update

The quota field is returned only when quota information applies. If no quota restriction applies, this field is omitted.

{
  "code": 0,
  "message": "Success",
  "request_id": "your_request_id",
  "data": {
    "video": {
      "id": "your_video_id",
      "quota": "quota information returned by TikTok Shop"
    }
  }
}

{
  "code": 0,
  "message": "Success",
  "request_id": "your_request_id",
  "data": {
    "photo": {
      "id": "your_photo_id",
      "quota": "quota information returned by TikTok Shop"
    }
  }
}

§5 What action is required

If your app uses the Post Shoppable Video API or Post Shoppable Photos API to publish shoppable content, review the following updates. Recommended actions:

Review the latest v202607 API reference for POST /affiliate_creator/202607/videos.
Confirm whether your app can determine if a submitted video is AI generated before calling the API.
Add video_info.is_ai_generated to your request body when using v202607.
Set video_info.is_ai_generated to true when the submitted video content is AI generated.
Update your response parsing logic for Post Shoppable Video and Post Shoppable Photos to handle the optional quota field.
Do not treat the absence of quota as an error; the field is omitted if no quota restriction applies.
Test the updated request in API Testing Tool before rolling it out to production traffic.

If you are unsure whether a specific video creation scenario should be treated as AI generated, please contact TikTok Shop support for guidance.

这条内容对你有帮助吗？