用途:按一个或多个搜索关键词发现公开 TikTok 帖子,由捆绑脚本完成创建、轮询和原始结果获取的完整流程。
主要能力:每个输入对象必须包含 search_keyword,可通过可重复的 --input-json 或一个含 JSON 数组的 --input-file 提供 1 至 20 个对象。字段与任务状态见 references/api.md。
使用方式:优先用 run 完成从创建到最终原始结果;需要分阶段时用 create、status、wait、result。示例:bash {baseDir}/scripts/tiktok_task.sh run --input-json '{"search_keyword":"#artist","num_of_posts":100,"country":"US"}';也可用 --input-file ./inputs.json --output ./out/tiktok-result.json。create --wait 等价于 run。认证用 FREVANA_TOKEN 或一次性 --token,默认基址 https://ai-factory.frevana.com,可用 FREVANA_API_BASE_URL 或 --api-base-url 覆盖。
限制:创建视为计费操作,省略时会生成并报告 client_task_id,创建超时或传输失败后只能用同一 ID 重试,不得自动提交新任务;轮询固定十秒间隔,遇 FAILED、EXPIRED 或 TRIGGER_UNKNOWN 应停止且不重提;结果字节原样返回,不得包装、重塑、合并、去重或按顺序/数量关联输入;不得混用 --input-file 与 --input-json;limit_per_input 为可选请求级整数,范围 1 至 2147483647;完整请求须在 1 MB 内;仅当 status=READY 且 billing_status=BILLED 时结果可用。该技能固定使用 POST /service/tiktok/posts/discover-by-keyword,不得用于其他 TikTok 操作。