Appearance
Ideogram 文生图
Ideogram 文生图适合海报、包装、文字排版、风格化插画和带明确视觉主题的图片生成。
接口路径
| 方法 | 路径 | 返回方式 |
|---|---|---|
POST | /ideogram/generate | 返回图片生成结果,以接口响应为准。 |
请求示例
bash
curl https://moonapix.com/ideogram/generate \
-H "Authorization: Bearer <MOONAPIX_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A premium coffee cup package design, clean background.",
"aspect_ratio": "1:1"
}'常用字段
| 字段 | 说明 |
|---|---|
prompt | 图片描述。 |
aspect_ratio | 图片比例,例如 1:1、16:9、9:16。 |
style_type | 风格类型,以 API Reference 为准。 |
结果处理
| 场景 | 处理方式 |
|---|---|
| 返回图片 URL | 保存图片 URL、prompt、比例和业务用途。 |
| 需要继续处理 | 将结果 URL 传给 Ideogram 放大 或 Ideogram 混合图。 |
| 生成失败 | 保留请求体和 trace 信息,便于排查模型、比例和输入内容。 |
接入建议
- 需要清晰文字排版时,把文案和布局要求写进 prompt。
- 建议保存 prompt、比例、结果 URL 和业务用途。
- 需要基于原图改造时使用 Ideogram 混合图。