开发者文档 / 带货内容发布

查询发布任务详情

GET/v1/creator/post/detail

鉴权：: 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
成功判断：: HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

Query 参数

字段	类型	必填	说明
`postId`	`string`	是	发布任务 ID

查询发布任务详情，包括 businessType、businessId 和 videoUrl。

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "postId": "2011014932023390208",
    "platform": "TIKTOK_BUSINESS",
    "businessType": "FILE",
    "businessId": "591",
    "title": "New collection",
    "videoUrl": "https://cdn.example.com/video.mp4",
    "snapshot": {
      "sourceFiles": [
        {
          "materialType": "VIDEO",
          "name": "video.mp4",
          "uploadedAt": "2026-09-29 10:00:00"
        }
      ]
    },
    "scheduledAt": 1790640000000,
    "scheduledTz": "Asia/Shanghai",
    "status": "SCHEDULED",
    "tiktokBusiness": {
      "musicSoundInfo": {
        "musicSoundId": "7123456789012345678",
        "musicSoundName": "Sunrise",
        "musicSoundArtist": "Example artist",
        "musicSoundVolume": 50,
        "videoOriginalSoundVolume": 50
      },
      "locationInfo": {
        "locationId": "loc-1",
        "locationName": "London"
      }
    }
  },
  "timestamp": 1790640000000
}

响应与错误

主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。

字段	类型	必填	说明
`code`	`integer`	是	—
`message`	`string`	是	—
`data`	`object`	是	—
`data.postId`	`string`	是	—
`data.platform`	`string`	是	—
`data.businessType`	`string`	否	素材来源，例如 FILE、EXTERNAL_URL
`data.businessId`	`string`	否	FILE 为文件 ID；EXTERNAL_URL 为原始 URL 的 SHA-256。原始 URL 见 videoUrl。
`data.title`	`string`	是	—
`data.videoUrl`	`string`	是	—
`data.snapshot`	`object \| null`	否	创建发布任务时保存的原始媒体快照；老数据或无文件快照时为 null。PHOTO 会返回全部源文件。
`data.snapshot.sourceFiles`	`object[]`	否	源文件列表，VIDEO 为单个文件，PHOTO 按原始图序返回全部文件。
`data.snapshot.sourceFiles[].materialType`	`string`	是	源媒体类型：VIDEO 或 PHOTO
`data.snapshot.sourceFiles[].name`	`string`	是	源文件名称
`data.snapshot.sourceFiles[].uploadedAt`	`string`	是	源文件上传时间
`data.scheduledAt`	`integer`	是	—
`data.scheduledTz`	`string`	是	—
`data.status`	`string`	是	—
`data.tiktokShop`	`union`	否	—
`data.tiktok`	`object`	否	—
`data.tiktok.coverTimestampMs`	`integer`	是	—
`data.tiktok.privacyLevel`	`string`	是	—
`data.tiktok.disableComment`	`boolean`	是	—
`data.tiktok.disableDuet`	`boolean`	是	—
`data.tiktok.disableStitch`	`boolean`	是	—
`data.tiktok.brandContentToggle`	`boolean`	是	—
`data.tiktok.brandOrganicToggle`	`boolean`	是	—
`data.tiktok.aigc`	`boolean`	是	—
`data.tiktokBusiness`	`object`	否	可选的 Business 视频设置，不包含 privacyLevel。coverFileId 优先于 coverTimestampMs；账号已禁用的互动只能设为禁用。
`data.tiktokBusiness.disableComment`	`boolean`	否	禁用评论；账号级已禁止评论时只能为 true
`data.tiktokBusiness.disableDuet`	`boolean`	否	禁用合拍；账号级已禁止合拍时只能为 true
`data.tiktokBusiness.disableStitch`	`boolean`	否	禁用拼接；账号级已禁止拼接时只能为 true
`data.tiktokBusiness.coverTimestampMs`	`integer`	否	视频封面截帧时间点（毫秒）
`data.tiktokBusiness.brandContentToggle`	`boolean`	否	品牌内容（付费合作推广）
`data.tiktokBusiness.brandOrganicToggle`	`boolean`	否	品牌自然流量（推广自己的业务）
`data.tiktokBusiness.aigc`	`boolean`	否	AI 生成内容
`data.tiktokBusiness.musicSoundInfo`	`object`	否	使用 musicSoundId（song_clip_id），不要使用 commercialMusicId。不传时不添加平台音乐；名称与作者仅为展示快照。
`data.tiktokBusiness.musicSoundInfo.musicSoundId`	`string`	否	热门曲目接口返回的 musicSoundId（平台的 song_clip_id），不能用 commercialMusicId
`data.tiktokBusiness.musicSoundInfo.musicSoundName`	`string`	否	曲名快照，仅用于展示与详情回填；发布以 musicSoundId 为准
`data.tiktokBusiness.musicSoundInfo.musicSoundArtist`	`string`	否	歌手快照，仅用于展示与详情回填
`data.tiktokBusiness.musicSoundInfo.musicSoundVolume`	`integer`	否	音乐音量 0-100；不传按 50（平台对未传的音量按 0 处理，等于静音）
`data.tiktokBusiness.musicSoundInfo.videoOriginalSoundVolume`	`integer`	否	原视频声音音量 0-100；不传按 50
`data.tiktokBusiness.locationInfo`	`object`	否	locationId 与 locationName 必须同时提交；locationAddress 仅用于展示。
`data.tiktokBusiness.locationInfo.locationId`	`string`	否	地域搜索接口返回的 locationId，发布时落到 post_info.location_id
`data.tiktokBusiness.locationInfo.locationName`	`string`	否	地域名称，发布时与 ID 一起传（post_info.location_name）
`data.tiktokBusiness.locationInfo.locationAddress`	`string`	否	地域补充地址，仅展示与详情回填，不发给平台
`data.tiktokBusinessPhoto`	`object`	否	TikTok Business 照片发布参数；platform=TIKTOK_BUSINESS 且 mediaType=PHOTO 时必填，不能与 tiktokShopPhoto 混用。图片用本系统文件 ID 传入，服务端解析成公开图片地址后发送；隐私级别取自该账号发布设置里可选的级别，不在列表里会直接判任务失败。
`data.tiktokBusinessPhoto.businessIds`	`integer[]`	是	图片文件 ID，顺序即图序，1～15 张
`data.tiktokBusinessPhoto.photoUrls`	`string[]`	否	服务端解析出的图片地址，请求不用传
`data.tiktokBusinessPhoto.photoCoverIndex`	`integer`	否	封面图下标，从 0 开始；不传按 0
`data.tiktokBusinessPhoto.privacyLevel`	`string`	是	隐私级别，必填；必须是该账号发布设置里可选的级别
`data.tiktokBusinessPhoto.autoAddMusic`	`boolean`	否	传入 musicSoundInfo.musicSoundId 时忽略此字段，服务端固定发送 false。
`data.tiktokBusinessPhoto.disableComment`	`boolean`	否	禁用评论；账号级已禁止评论时只能为 true
`data.tiktokBusinessPhoto.brandOrganicToggle`	`boolean`	否	品牌自然流量（推广自己的业务）
`data.tiktokBusinessPhoto.brandContentToggle`	`boolean`	否	品牌内容（付费合作推广）
`data.tiktokBusinessPhoto.locationInfo`	`object`	否	locationId 与 locationName 必须同时提交；locationAddress 仅用于展示。
`data.tiktokBusinessPhoto.locationInfo.locationId`	`string`	否	地域搜索接口返回的 locationId，发布时落到 post_info.location_id
`data.tiktokBusinessPhoto.locationInfo.locationName`	`string`	否	地域名称，发布时与 ID 一起传（post_info.location_name）
`data.tiktokBusinessPhoto.locationInfo.locationAddress`	`string`	否	地域补充地址，仅展示与详情回填，不发给平台
`data.tiktokBusinessPhoto.musicSoundInfo`	`object`	否	选中的商用音乐，与非带货视频是同一份结构；不传（或不传 musicSoundId）表示这次不加平台音乐。图文发布没有音量参数：只把 musicSoundId 发给 TikTok（落到 post_info.music_sound_info.music_sound_id），曲名与歌手仅供展示与详情回填。
`data.tiktokBusinessPhoto.musicSoundInfo.musicSoundId`	`string`	否	热门曲目接口返回的 musicSoundId（平台的 song_clip_id），不能用 commercialMusicId；图文发布时落到 post_info.music_sound_info.music_sound_id
`data.tiktokBusinessPhoto.musicSoundInfo.musicSoundName`	`string`	否	曲名快照，仅用于展示与详情回填；发布以 musicSoundId 为准
`data.tiktokBusinessPhoto.musicSoundInfo.musicSoundArtist`	`string`	否	歌手快照，仅用于展示与详情回填
`timestamp`	`integer`	是	—

参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。

最后更新 · 2026-09-29