API 文档

按正式请求合同接入模型、生成任务、错误处理与 Webhook。

管理 API Key

文档只描述已实现合同。模型 ID、尺寸、时长、价格和余额必须从正式接口读取；服务端不会静默替换不受支持的参数。

快速开始

从 Key 到首个请求

所有生成请求从服务端保存的 API Key 开始。先读取正式模型目录，再提交带幂等键的请求，最后按真实任务状态查询或接收 Webhook。

创建 API Key

选择最小权限、模型白名单、积分预算和请求配额。完整 Key 只显示一次。

读取模型目录

调用 GET /api/v1/models 获取当前可用模型及受支持参数，不在客户端固化目录。

创建并追踪任务

提交唯一 Idempotency-Key，保存返回的 Job ID、Request ID 与真实预扣积分。

服务端使用

生产 Key 不应进入浏览器脚本、移动安装包或公开仓库。

示例cURL

BASE URLhttps://cano.gewuzhihui.com

curl -X POST "https://cano.gewuzhihui.com/api/v1/images/generations" \
  -H "Authorization: Bearer $CANO_API_KEY" \
  -H "Idempotency-Key: image-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<GET /api/v1/models 返回的图片模型 ID>",
    "prompt": "写实产品摄影，棚拍柔光",
    "size": "<模型目录返回的受支持尺寸>",
    "n": 1
  }'

示例不会在文档页执行。模型与参数占位符必须替换为正式模型目录返回值。