首页 / 图像 API
图像 API
苏姆卡皮 · OpenAI 兼容 AI API 网关 · Base URL https://sub.sumcapi.top/v1
文生图与图像编辑共用一套任务式接口,换模型不换代码;按分辨率与张数计费,适合电商视觉、营销素材与封面批量生产。
图像 API
能力范围
- 文生图(Text-to-Image):一句提示词生成图片,支持尺寸、数量、风格参考等参数。
- 图像编辑(Image-to-Image / Inpainting):传入原图与遮罩或提示词,完成换风格、局部修改、抠图。
- 批量生成:一次提交多条提示词,任务完成后统一取回结果。
接口形状
curl https://sub.sumcapi.top/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "图像模型名",
"prompt": "白底商品图,柔光,俯视 45 度,细节清晰",
"n": 1,
"size": "1024x1024"
}'
部分模型采用异步任务式返回:先创建任务拿到 task_id,再轮询结果端点。建议把轮询间隔设为 3–5 秒,并为单个任务设置总超时。
from openai import OpenAI
client = OpenAI(base_url="https://sub.sumcapi.top/v1", api_key="sk-你的密钥")
img = client.images.generate(
model="图像模型名",
prompt="赛博朋克城市夜景,霓虹,雨后地面反光",
size="1024x1024",
n=1,
)
print(img.data[0].url)
提示词与成本实践
- 先用低分辨率做风格探索,定稿后再跑高分辨率,批量任务成本可以下降一个数量级。
- 把可复用的部分固化成模板:主体、构图、光线、材质、负面提示,逐项替换比整段重写稳定。
- 商品图优先约束背景与光照,再谈风格;否则同一批素材会出现色温差。
计费与限流
- 图像按张计费,价格随分辨率与模型档位变化,明细见 模型定价。
- 失败任务不计费;上游返回错误时账单不会产生对应条目。
- 批量提交建议控制在个位数并发,遇到
429使用指数退避。
苏姆卡皮