开发者

API 与 MCP 文档

用 REST API 或让 AI 助手通过 MCP 完成整套广告复刻：找模板 → 上传产品图 → 审脚本 → 估价 → 生成 → 轮询 → 导出。计费、冻结和试用规则与网页完全一致。

鉴权

在 设置 → API 密钥 创建密钥（read / write / spend 权限），以 Bearer 方式发送。密钥只显示一次。

Authorization: Bearer rk_live_…

计费规则

• 100 积分 = $1。分析、脚本、分镜静帧、出视频前改台词免费。
• 视频按生成秒数计费，分辨率只有 720p / 1080p / 2K，建项目时确定。
• generate_video 与 export_video 必须带 confirm: true 才会扣积分，否则只返回估价（402 confirmation_required）。
• 所有创建或扣费的 POST 请带 Idempotency-Key，重试不会重复扣费。

MCP

远程 MCP（Streamable HTTP）： https://adrecast.com/api/mcp

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Remake proven video ads for the user's product. Flow: search_templates → create_upload_url (PUT each product image) → create_project → poll get_project → get_script / update_script → estimate_cost (show the user) → generate_video with confirm=true → poll get_job / list_clips → export_video confirm=true → get_export.download_url. Never set confirm=true without the user approving the credit estimate. Resolutions: 720p, 1080p, 2K.

REST v1

Base URL https://adrecast.com/api/v1 · OpenAPI /api/v1/openapi.json

示例

API=https://adrecast.com/api/v1
H="Authorization: Bearer $ADRECAST_API_KEY"
curl -s -X POST $API/templates/search -H "$H" -H 'Content-Type: application/json' -d '{"query":"vitamin c serum"}'
curl -s -X POST $API/projects/$PID/estimate -H "$H" -H 'Content-Type: application/json' -d '{}'
curl -s -X POST $API/projects/$PID/generate -H "$H" -H 'Content-Type: application/json' \
  -H "Idempotency-Key: gen-$PID-1" -d '{"confirm":true,"max_credits":600}'

Webhooks

事件 job.completed / job.failed。校验签名：

AdRecast-Signature: t=<unix>,v1=<hex>      // same value also sent as legacy Replica-Signature
v1 = HMAC_SHA256(secret, "<t>.<raw body>")   // reject if |now - t| > 300 s; dedupe by body.id

AI 助手技能

给 Claude / Cursor 等助手用的 SKILL.md： SKILL.md (通用版: ad-remake-api) · 30 tools.