首页 / 模型指南 / Ideogram 3

30 秒结论

• 它擅长什么：以图中文字渲染见长，适合带标语的海报与封面，走 /v1/images/generations 一个端点即可开始。
• 怎么接：把 OpenAI SDK 的 base_url 改成 https://sub.sumcapi.top/v1，api_key 换成苏姆卡皮密钥，模型名填 Ideogram 3。
• 注意什么：图像生成与编辑 以控制台与模型广场实时展示为准；生产链路请配置超时、退避与兜底模型。

接口与关键参数

鉴权统一使用 Authorization: Bearer <API_KEY>。返回的临时地址有有效期，请立刻转存到你自己的存储

请求示例

cURL

curl https://sub.sumcapi.top/v1/images/generations \
  -H "Authorization: Bearer $SUMCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Ideogram 3",
    "prompt": "白底商品图，柔光，俯视 45 度，细节清晰，画面内无文字",
    "size": "1024x1024",
    "n": 1
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(base_url="https://sub.sumcapi.top/v1", api_key="sk-你的密钥")
img = client.images.generate(
    model="Ideogram 3",
    prompt="赛博朋克城市夜景，霓虹，雨后地面反光",
    size="1024x1024",
    n=1,
)
print(img.data[0].url)   # 临时地址有有效期，请及时转存

响应要点

• 结果地址有有效期，落库前先下载转存。
• 建议记录请求 ID：排查问题与计费争议都需要它。
• 同名模型可能由不同渠道提供，输出风格会有细微差异，切模型前做一轮回归。

常见错误与处理

计费口径

• 按 张 或按 任务 计费，分辨率与质量档位决定单价，明细见 模型定价。
• 失败任务不计费；被内容策略拒绝的请求不产生账单条目。
• 先用低分辨率做风格探索，定稿再跑高分辨率，批量成本通常能降一个数量级。
• 生成与编辑价格不同，接口形状见 图像 API。

适用场景

• 电商主图：白底、柔光、固定视角的模板化提示词，批量出图后人工挑选。
• 营销素材：封面、Banner、活动海报，配合文字渲染能力减少后期排版。
• 素材二次加工：局部重绘、换背景、换风格走图像编辑接口。
• 概念设计：风格探索阶段用低档参数快速试错。

选型建议

Logo 文字、标语海报。同一能力建议同时配置 2 个以上候选模型，网关会在限流与过载时自动切换，见 路由与错误。

接入三步

1. 在控制台创建密钥并绑定包含该模型的分组；
2. 用上面的示例跑通一次最小请求，确认 model 返回模型名；
3. 把 model 做成配置项，在 模型广场 对照可用清单，逐步迁移业务链路。

相关模型（图像生成与编辑）

想看全部能力入口，见 模型指南 与 能力与场景。

常见问题