PionicAI - 图片生成 API

适用场景

文生图：根据文字提示生成图片。
图生图/图片编辑：上传参考图，按提示词修改风格、背景、主体或尺寸。
批量素材：为产品图、文章配图、应用封面生成候选图。
具体可用模型、尺寸和价格以 PionicAI 控制台为准。

鉴权与基础配置

Base URL	`https://api.pionicai.com/v1`
文生图路径	`POST /v1/images/generations`
图片编辑路径	`POST /v1/images/edits`
认证	`Authorization: Bearer YOUR_API_KEY`
示例模型	`gpt-image-1` 或控制台显示的图片模型

模型名以控制台为准

不同渠道可用的图片模型可能不同。如果示例模型不可用，请到控制台模型列表复制实际模型名。

文生图 curl 示例

curl https://api.pionicai.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-pionicai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A clean product poster for an AI API gateway, white background, blue accent",
    "size": "1024x1024"
  }'

图生图/编辑 curl 示例

curl https://api.pionicai.com/v1/images/edits \
  -H "Authorization: Bearer sk-your-pionicai-key" \
  -F model=gpt-image-1 \
  -F image=@input.png \
  -F prompt="保持主体不变，改成干净的科技风海报" \
  -F size=1024x1024

常用参数

model	必填。使用控制台可用图片模型。
prompt	必填。描述主体、风格、构图、背景、光线、色彩。
size	推荐。常见如 1024x1024、1536x1024、1024x1536，实际支持以模型为准。
quality	可选。不同模型支持不同质量档位。
response_format	可选。部分兼容接口支持 url 或 b64_json。
image	编辑接口必填，可上传参考图片。

提示词建议

写清楚主体：人物、产品、场景、动作。
写清楚风格：写实、插画、3D、扁平、海报、UI 截图等。
写清楚构图：居中、特写、留白、全身、俯视等。
写清楚输出限制：不要文字、水印、变形手指、低清晰度等。

错误处理

400：缺少 prompt、图片格式不支持、尺寸参数不支持。
401：API Key 无效或未填写。
404：模型名不可用或接口路径写错。
429：频率过高或额度不足。
500/504：生成耗时或上游异常，降低尺寸或稍后重试。