B 端 / 开发者

API 与开放能力

将 Aether Studio 的创作能力接入你的系统 —— 注册即得 API Key,按量计量,MCP 开放协议。

1

注册获取 API Key

注册即得 hs_ 前缀 API Key(明文仅注册时返回一次,请妥善保存)。

curl -X POST https://zhidahengtong.com/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"acme","name":"ACME","role":"user"}'
# -> {"id":363, "api_key":"hs_5214..."
2

订阅 / 计量付费

B 端调用走积分计量。订阅套餐补足额度,按量扣费,交易流水可对账。

# 订阅专业版 (99 元/月, 3000 积分, 1080p)
curl -X POST https://zhidahengtong.com/api/billing/subscribe \
  -H "X-API-Key: ***" -H "Content-Type: application/json" \
  -d '{"plan":"pro"}'
# -> {"plan":"pro","credits":3000}

# 计量扣费 (扁平整数对象: 出图/配音/合成 数量)
curl -X POST https://zhidahengtong.com/api/billing/consume \
  -H "X-API-Key: ***" -H "Content-Type: application/json" \
  -d '{"image":2,"tts":1,"composite":1}'
# -> {"ok":true,"cost":8,"credits":2992,"used":8}

# 交易流水对账
curl https://zhidahengtong.com/api/billing/transactions -H "X-API-Key: ***"
3

调用工作流能力 (B 端 API)

对外开放 API 直接驱动创作工作流与 43 项注册表能力,鉴权统一 X-API-Key。

# 一键成片 (ManhuaGraph: 剧本 -> 分镜 -> 出图 -> 配音 -> 合成)
curl -X POST https://zhidahengtong.com/api/open/workflow \
  -H "X-API-Key: ***" -H "Content-Type: application/json" \
  -d '{"script":"场景1:古镇石桥 场景2:戏台后台","dimension":"2d","resolution":"1080p","aspect":"portrait"}'
# -> status:completed, overall_score:8.1, steps:9

# 单能力执行 (注册表代执行)
curl -X POST https://zhidahengtong.com/api/open/execute \
  -H "X-API-Key: ***" -H "Content-Type: application/json" \
  -d '{"capability":"expert:screenwriter","args":{"task":"写悬疑短剧大纲"}}'