图片生成 API

图片生成兼容 OpenAI Images 协议。只有生图模型(模型目录里按「张」计价的模型)可以调用,对话接口不接受生图模型。

生成图片

POST https://api.admesh.ai/v1/images/generations
curl https://api.admesh.ai/v1/images/generations \
  -H "Authorization: Bearer $ADMESH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model-id>",
    "prompt": "A watercolor lighthouse on a cliff at dawn",
    "n": 1
  }'

返回标准 OpenAI Images 响应,data 数组里每一项是一张图片(url 或 b64_json,取决于模型)。

请求字段

字段 说明
model 必填,生图模型 ID
prompt 必填,文本描述
n 生成张数,正整数,默认 1,单次最多 10
size 等 其它 OpenAI Images 参数按模型支持透传

不支持 stream。

计费

  • 提交时按「张数 × 每张价格」冻结余额,余额不足返回 402 insufficient_balance。
  • 完成后按实际返回的张数(不超过 n)结算,多冻结的部分自动释放;不按 Token 计费。
  • 生成失败不计费。