估算生图价格 · Calculate Image Price

根据分辨率与宽高比，估算生成一张图片预计消耗的钻石（credits）。常用于在调用 对话生图 之前，给用户预览本次扣费。

该接口只做计算、不产生扣费，返回的是「单张图片」的预估价格。

接口地址

POST https://xiangcao.ai/api/calculate-image-price

该接口为普通接口，使用 POST 方法。

鉴权

需要在请求头携带 API Key：

Authorization: Bearer <YOUR_API_KEY>

缺少或无效的 Token 会返回 401。

请求体（JSON）

类型定义（TypeScript）

type AspectRatioType = 'PORTRAIT' | 'LANDSCAPE' | 'SQUARE';
type ResolutionType = 'SD' | 'HD' | 'UHD';

interface CalculateImagePriceRequest {
  /** 宽高比 */
  aspectRatio: AspectRatioType;
  /** 分辨率类型 */
  resolutionType: ResolutionType;
}

响应（JSON）

interface CalculateImagePriceResponse {
  /** 单张图片预计消耗的钻石（credits）总数 */
  estimatedTotalPrice: number;
}

计费说明

价格单位为钻石（credits），由分辨率与宽高比共同决定：

• 分辨率越高越贵：UHD > HD > SD。
• 宽高比目前不影响价格（PORTRAIT / LANDSCAPE / SQUARE 价格相同），但仍为必填参数。

当前各分辨率的价格参考如下（请以接口返回的 estimatedTotalPrice 为准）：

示例

请求：

curl -X POST "https://xiangcao.ai/api/calculate-image-price" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "aspectRatio": "PORTRAIT",
    "resolutionType": "HD"
  }'

响应：

{
  "estimatedTotalPrice": 1500
}

错误处理

出错时返回相应 HTTP 状态码及 JSON：{ "error": "..." }。