图像生成 API

文生图接口。Host 与 Key 都是本站。

# 推荐（OpenAI 习惯）
POST https://api.ashpetals.com/v1/images/generations
POST https://api.ashpetals.com/v1/images/edits

# 路径别名（xAI / Gemini 文档习惯，本站同样受理）
POST https://api.ashpetals.com/xai/v1/images/generations
POST https://api.ashpetals.com/xai/v1/images/edits
POST https://api.ashpetals.com/v1beta/models/{imagen*}:predict

协议对照

客户端习惯	本站路径	说明
OpenAI Images	/v1/images/generations · /v1/images/edits	推荐
xAI 官方文档的路径	/xai/v1/images/generations · /xai/v1/images/edits	本站兼容；Host 仍是本站
Gemini 官方 Imagen	/v1beta/models/{imagen*}:predict	原生体 instances / parameters 可走；也可改用 OpenAI 体
直接打 api.x.ai / generativelanguage.googleapis.com 却填本站 Key	❌	Host 必须是本站

1. OpenAI 路径（推荐）

curl https://api.ashpetals.com/v1/images/generations \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux",
    "prompt": "一只戴宇航头盔的柴犬，赛博朋克风格",
    "size": "1024x1024",
    "n": 1
  }'

Grok Imagine 图：

curl https://api.ashpetals.com/v1/images/generations \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "A calico cat playing piano on stage"
  }'

或 xAI 路径：

curl https://api.ashpetals.com/xai/v1/images/generations \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-image","prompt":"…"}'

图编辑走 /v1/images/edits 或 /xai/v1/images/edits，模型示例 grok-imagine-edit。

2. Gemini Imagen 原生路径

curl https://api.ashpetals.com/v1beta/models/imagen-4.0-generate-001:predict \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{"prompt": "一只戴宇航头盔的柴犬"}],
    "parameters": {"sampleCount": 1}
  }'

模型名以 GET /v1/models 为准，需是 imagen* 前缀。也可用 OpenAI 体打 /v1/images/generations。

参数（OpenAI 体）

参数	类型	说明
model	string	必填，图像模型 ID（以 /v1/models 为准）
prompt	string	必填，图像描述
size	string	可选，输出尺寸（如 1024x1024）
n	int	可选，生成数量（按次计费时注意费用）
response_format	string	可选，url（默认）或 b64_json

按次计费说明

图像模型按生成次数计费（非按 token），单次价格以 模型广场 为准。请合理设置 n 参数控制成本。

注意事项

• 部分模型对提示词有内容限制，违规内容会被拒绝。
• 生成失败不扣费或按站点策略处理，以实际扣费记录为准。
• 令牌分组需能访问对应模型（Grok Imagine 图像请用 Grok-Main）。