价格与运行时
- 当前价格
- 每次运行 25 Credits
- 超时上限
- 最长 1800 秒
- 品牌上下文
- 可选——传入 brand_context_id
价格按真实运行成本校准、可能调整——以创建运行时返回的 credit_cost 为准。
输入参数
以 input 对象传入 POST /api/v1/runs。
| 键 | 类型 | 必填 | 标签与说明 |
|---|---|---|---|
| brand | short_text | 可选 | 品牌你的品牌名。与品类二选一必填。 |
| product_or_category | short_text | 可选 | 产品或品类要研究的产品或品类。与品牌二选一必填。 |
| competitors | long_text | 可选 | 竞品每行填写一个竞品，也可以用英文逗号分隔。 |
| subreddits | long_text | 可选 | 版块每行填写一个版块，也可以用英文逗号分隔。 |
| date_from | short_text | 可选 | 开始日期起始日期，格式 YYYY-MM-DD。默认最近 90 天。 |
| date_to | short_text | 可选 | 结束日期结束日期，格式 YYYY-MM-DD。 |
| max_posts | number | 可选 | 最大帖子数采集帖子上限（1-100，默认 20）。 |
| max_comments_per_post | number | 可选 | 每帖评论上限每帖评论上限（0-20，默认 5）。评论也算独立声音。 |
| interaction_language | select | 可选 | 报告语言控制最终报告的输出语言。可选值：英文, 中文 |
请求示例
示例覆盖全部必填字段，可选字段按同样方式传入。
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": "reddit-product-opportunity",
"input": {}
}'返回内容
201 响应返回 run_no、credit_cost、stream_url 与 result_url（相对路径）。从 stream_url 订阅进度，从 result_url 取回终态结果（summary 与 output）。结果在 App 的保留窗口内可取（默认 30 天）。