套餐
API 总览

广告创意

ad-creative

从你自己的证明素材生成有据可依的广告创意,或基于优胜素材迭代,逐条按平台规格校验并标注来源。

价格与运行时

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

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

输入参数

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

键类型必填标签与说明
product_descriptionshort_text必填产品产品是什么。
platformselect可选平台哪个广告平台。可选值:Google Ads, Meta (FB/IG), LinkedIn, TikTok, YouTube
modeselect可选模式新批次或迭代优化。可选值:从素材生成, 按数据迭代
audience_contextshort_text可选受众是谁、认知阶段、核心痛点。
proof_materiallong_text必填依据素材你的优胜广告、评论原文、广告留言。
performance_datalong_text可选绩效数据迭代模式用的现有创意数据。
constraintsshort_text可选约束禁用词、合规要求、必含元素。
batch_sizeselect可选批量创意数量。可选值:小(约6), 中(约12), 大(约20)
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": "ad-creative",
  "input": {
    "product_description": "example text",
    "proof_material": "example text"
  }
}'

返回内容

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