跳到主内容
clonesite.ai
菜单

Clone API · Live 暂停

代码生成暂停， 即将回归。

Live 代码生成已暂停。新 live 请求返回 503 clone_generation_paused，不扣 credits、不创建 request 或 job。API key 管理与免费 test run 继续可用。

管理 key 与测试查看 API 契约

Live 暂停 · 免费 test run · REST 与 MCP

POST /api/v1/clone-requests/test-runs
curl -X POST https://clonesite.ai/api/v1/clone-requests/test-runs \
-H "Authorization: Bearer cs_live_..." \
-H "Idempotency-Key: req_8273" \
-H "Content-Type: application/json" \
-d '{ "sourceUrl": "https://linear.app",
"prompt": "Clone as editable React." }'
202 Accepted
{
"id": "api_req_abc123",
"status": "queued",
"mode": "test",
"statusUrl": "/api/v1/clone-requests/api_req_abc123"
}

集成测试

继续准备你的集成

01

管理 API key

在 /developers 创建或撤销 key，无需购买 credits 即可测试。

Authorization: Bearer cs_live_...
02

检查可用性

Preflight 返回 canCreate=false、checks.generation=paused 与 wouldChargeCredits=0。

POST /api/v1/clone-requests/preflight
03

免费 test run

用 mock 输出验证轮询、签名 webhook 与 fixture ZIP 下载，不执行真实代码生成。

POST /api/v1/clone-requests/test-runs

测试生命周期

免费 mock 请求会进入 ready 或 failed，不创建真实 generation job。

mode: test

无需购买

Test run 与 fixture ZIP 下载均为 0 credits。新 live 请求在扣费前被拦截。

0 credits

REST 与 MCP

同一把 key 可用于 REST 与托管 MCP，两者都执行相同的 live 暂停规则。

clonesite.ai/openapi.json · /mcp

Preflight 与 test run

检查暂停状态，测试集成流程

Preflight 在校验 payload 与账号设置的同时报告 live 暂停。免费 test run 用 mock 输出验证集成行为。

  • canCreate=false · checks.generation=paused · wouldChargeCredits=0
  • 免费测试请求支持可选签名 webhook
  • 轮询与 fixture ZIP 下载继续可用
POST /api/v1/clone-requests/preflight
curl -X POST https://clonesite.ai/api/v1/clone-requests/preflight \
-H "Authorization: Bearer cs_live_..." \
-H "Content-Type: application/json" \
-d '{ "sourceUrl": "https://linear.app", ... }'
200 OK · no charge
{
"canCreate": false,
"wouldChargeCredits": 0,
"checks": { "generation": "paused" }
}
free test run
curl -X POST https://clonesite.ai/api/v1/clone-requests/test-runs \
-H "Authorization: Bearer cs_live_..." \
-H "Idempotency-Key: test_8273" \
-H "Content-Type: application/json" \
-d '{ ..., "scenario": "ready" }'
# 202 · mode: test · 0 credits
# when ready: POST /source-downloads
# returns a fixture ZIP · 0 credits

Webhooks

验证测试回调

轮询只需 API key。测试回调时，在 /developers 配置 signing secret，并在 test run 中传 callbackUrl。

  • 账号级 signing secret
  • Standard Webhooks HMAC-SHA256 签名
  • 测试 ready 与 failed 终态事件
POST your callback URL
webhook-id: evt_abc123
webhook-timestamp: 1781946000
webhook-signature: v1,base64(hmac_sha256(...))
{ "event": "clone.ready",
"cloneRequestId": "api_req_abc123",
"artifactSlug": "api-test-fixture",
"sourceZip": { "available": true, "creditCost": 0 }
}
verify
const sig = base64HmacSha256(secret, `${id}.${ts}.${body}`)
if (`v1,${sig}` !== header) return reject(401)

生成暂停期间

准备你的集成

管理 API key

创建和撤销凭证，无需购买 credits。

集成测试

验证轮询、webhook 签名与 fixture 下载。

历史请求

可继续读取状态。同 key、同 payload 重放只读返回现状，不触发新履约。

免费集成测试

Live 生成暂停 · Test run 无需 credits

管理 API key

常见问题

哪些能力仍可用？

能创建 live clone 吗？

Live 代码生成已暂停，即将回归。新请求返回 HTTP 503 与 clone_generation_paused，不扣费，也不创建 API request 或 job。

还能测试吗？

可以。使用 API key 或 OAuth access token，免费 test run、轮询、签名 webhook 与 fixture ZIP 下载继续可用。

重试会怎样？

同一幂等 key 与 payload 只读返回已有请求，不触发新履约。不同 payload 返回 409 idempotency_conflict。历史排队或处理中的任务不会恢复生成。

何时回归？

尚无确定日期，请关注上方回归公告。API key 管理与 test 模式继续可用。

让你的集成 准备就绪。

Live 生成暂停期间，继续管理 API key、免费测试流程。

管理 key 与测试

clonesite.ai/developers