API 与开发者集成

API Keys

签发后用 Authorization: Bearer mk_… 调用公开接口，按次扣积分。明文只展示一次，请立即保存。

REST 接口

推荐用 API Key 调 /api/v1/generate 出单图；画布里存下的**工作流**可按 id 跑（列表 → 运行 → 轮询）。站内接口也可用会话 Cookie 调用：

curl -X POST https://makegame.ai/api/v1/generate \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer mk_...' \
  -d '{
    "agentId": "pixel",
    "prompt": "a pixel treasure chest"
  }'

• POST/api/v1/generate公开生成接口（API Key 鉴权）
• GET/api/v1/workflows列出我保存的工作流（含可传参节点）
• POST/api/v1/workflows/:id/run按 id 运行工作流（可覆盖节点提示词）
• GET/api/v1/runs/:runId轮询运行进度，每次推进一个节点
• POST/api/v1/video提交视频生成（异步，提交即扣 180 积分）
• GET/api/v1/video/:id轮询视频任务（失败自动退款）
• POST/api/ai/stream流式生成（SSE，会话鉴权）
• POST/api/ai/generate一次性生成（会话鉴权）
• GET/api/ai/agents可用智能体列表