Publora — TikTok

TikTok 平台技能，适用于 Publora API。关于认证、核心排期、媒体上传及工作区/回调文档，请参阅 publora 核心技能。

基础 URL： https://api.publora.com/api/v1

请求头： x-publora-key: sk_YOUR_KEY

平台 ID 格式： tiktok-{userId}

平台限制（API）

⚠️ TikTok API 对字幕和时长的要求比原生应用更严格。

常见错误：

• spam_risk_too_many_posts — 已达到每日上限，需等待 24 小时
• duration_check_failed — 视频时长必须在 3 秒至 10 分钟之间
• unaudited_client_can_only_post_to_private_accounts — 应用未通过 TikTok 审核

⚠️ 如果您的 TikTok 应用未通过 TikTok 审核，所有发布的视频将默认为私密状态。

上传 TikTok 视频

TikTok 仅支持视频内容。请使用三步上传流程：

// 步骤 1：创建帖子（草稿，不设置 scheduledTime，或设置排期）
const post = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: '你的 TikTok 字幕 #热门',
    platforms: ['tiktok-123456789'],
    scheduledTime: '2026-03-20T18:00:00.000Z'
  })
}).then(r => r.json());

// 步骤 2：获取上传地址
const upload = await fetch('https://api.publora.com/api/v1/get-upload-url', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postGroupId: post.postGroupId,
    fileName: 'video.mp4',
    contentType: 'video/mp4',
    type: 'video'
  })
}).then(r => r.json());

// 步骤 3：将视频上传至 S3
await fetch(upload.uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'video/mp4' },
  body: videoFileBytes
});

Python 示例

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# 步骤 1：创建帖子
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': '你的 TikTok 字幕 #爆火',
    'platforms': ['tiktok-123456789'],
    'scheduledTime': '2026-03-20T18:00:00.000Z'
}).json()

# 步骤 2：获取上传地址
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'postGroupId': post['postGroupId'],
    'fileName': 'video.mp4',
    'contentType': 'video/mp4',
    'type': 'video'
}).json()

# 步骤 3：上传视频
with open('video.mp4', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'video/mp4'}, data=f)

平台特性说明

• 仅支持视频 —— 通过 API 无法发布图片或纯文字内容
• 最短时长：3 秒；通过 API 的最大时长为 10 分钟
• 未审核的应用默认私密发布 —— 若 Publora TikTok 应用未通过 TikTok 审核，所有视频将自动设为私密
• 字幕长度限制为 2,200 字符（API）（不同于原生应用的 4,000 字符）—— 请保持字幕简洁
• 每日发布上限：15–20 条/天，由 TikTok 强制执行