基础信息
| Base URL | https://masi.cc.cd |
|---|---|
| 格式 | application/json |
| 单批上限 | 10个不同AT |
| 同一CDK并发 | 最多10个任务 |
| 单个AT | 运行期间自动去重，只创建一个任务 |
CDK认证
请求头携带CDK：
X-CDK: KSCAN-XXXX-XXXX-XXXX Content-Type: application/json
只有任务成功并返回付款链接才扣除1次。失败或取消不扣次数。
POST /v1/kakao/jobs
提交一个ChatGPT access_token。
curl -X POST 'https://masi.cc.cd/v1/kakao/jobs' \
-H 'Content-Type: application/json' \
-H 'X-CDK: YOUR_CDK' \
-d '{"access_token":"YOUR_ACCESS_TOKEN"}'{"ok":true,"job":{"job_id":"JOB_ID","status":"queued"}}GET /v1/kakao/jobs/{job_id}
curl 'https://masi.cc.cd/v1/kakao/jobs/JOB_ID' -H 'X-CDK: YOUR_CDK'
{
"ok": true,
"job": {
"job_id": "JOB_ID",
"status": "completed",
"output": {"long_url": "https://..."}
}
}POST /v1/kakao/jobs/{job_id}/cancel
取消尚未结束的任务，取消成功不扣CDK。
curl -X POST 'https://masi.cc.cd/v1/kakao/jobs/JOB_ID/cancel' \
-H 'Content-Type: application/json' \
-H 'X-CDK: YOUR_CDK' -d '{}'GET /v1/cdk/status
curl 'https://masi.cc.cd/v1/cdk/status' -H 'X-CDK: YOUR_CDK'
{"ok":true,"cdk":{"total_uses":10,"remaining_uses":8,"pending_uses":1,"available_uses":7}}任务状态与扣费
| 状态 | 含义 | 扣费 |
|---|---|---|
queued | 排队 | 预留额度 |
running | 提炼中 | 预留额度 |
completed | 成功返回链接 | 扣除1次 |
failed | 失败 | 释放额度 |
canceled | 取消 | 释放额度 |
常见HTTP状态：400 参数错误，401 CDK无效，429 并发达到上限，502 上游暂不可用。
Python完整示例
import time
import requests
base = "https://masi.cc.cd"
headers = {"X-CDK": "YOUR_CDK", "Content-Type": "application/json"}
created = requests.post(base + "/v1/kakao/jobs", headers=headers,
json={"access_token": "YOUR_ACCESS_TOKEN"}, timeout=30).json()
job_id = created["job"]["job_id"]
while True:
job = requests.get(base + f"/v1/kakao/jobs/{job_id}",
headers=headers, timeout=30).json()["job"]
if job["status"] == "completed":
print(job["output"]["long_url"])
break
if job["status"] in {"failed", "canceled"}:
raise RuntimeError(job.get("error") or job["status"])
time.sleep(2.5)