套餐
API 总览

UGC 内容矩阵

ugc-matrix

建立可重复执行的创作者内容项目,明确角色、内容形态、激励、发布和安全检查。

价格与运行时

当前价格
每次运行 25 Credits
超时上限
最长 2400 秒
品牌上下文
可选——传入 brand_context_id

价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。

输入参数

以 input 对象传入 POST /api/v1/runs。

键类型必填标签与说明
product_descriptionshort_text必填产品产品是什么。
use_caseslong_text可选核心用例每行填写一个用例,也可以用英文逗号分隔。
target_marketshort_text可选目标市场决定市场进入顺序。
main_platformselect可选主平台矩阵首先落地的平台。可选值:短视频, Instagram, YouTube, Threads, 小红书类
budget_noteshort_text可选预算与目标预算与创作者数量目标。
ip_account_statuslong_text可选IP 号现状已有 IP/品牌号吗?飞轮的起点。
winning_formatlong_text可选已验证格式已验证的格式;留空则方案含验证程序。
brand_guardrailslong_text可选品牌边界内容禁区与调性。
competitor_noteslong_text可选待拆竞品启用拆竞品模块。
interaction_languageselect可选报告语言控制最终报告的输出语言。可选值:英文, 中文

请求示例

示例覆盖全部必填字段,可选字段按同样方式传入。

curl -X POST https://api.TODO-APP-DOMAIN/api/v1/runs \
  -H "Authorization: Bearer $SUPAMARKETERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_slug": "ugc-matrix",
  "input": {
    "product_description": "example text"
  }
}'

返回内容

201 响应返回 run_no、credit_cost、stream_url 与 result_url(相对路径)。从 stream_url 订阅进度,从 result_url 取回终态结果(summary 与 output)。结果在 App 的保留窗口内可取(默认 30 天)。