将 Ideogram 4.5 接入你的流程。

给开发者的简明 API 说明。先选择供应商，再使用对应的数据格式与认证方式。

你的提示词

柔和工作室光线下的钴蓝色陶瓷杯。

→

Ideogram 4.5

排队中处理中已完成

保留同一个请求

→

图片结果

两类任务，两个接口

官方生成接口为 /v2/image/generate/ideogram-4-5 ，精确编辑接口为 /v2/image/precise-edit/ideogram-4-5。生成需要提示词，精确编辑还需要原图。

在 fal 上，对应的模型 ID 为 ideogram/v4.5 和 ideogram/v4.5/edit。精确编辑时，将 edit_precision 设为 high 以使用高精度编辑。不同供应商的字段名称不同。

任务排队，稍后获取结果

只提交一次并保存返回的请求 ID。持续查询同一任务直到完成，再获取图片。刷新浏览器或遇到临时网络错误时，应查询原有任务，避免重复付费生成。

// Run this on your server. FAL_KEY stays server-side.
const job = await fetch(
  'https://queue.fal.run/ideogram/v4.5',
  {
    method: 'POST',
    headers: {
      Authorization: 'Key ' + process.env.FAL_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      prompt: 'A cobalt ceramic cup in soft studio light',
      quality: 'low',
      image_size: 'square_hd',
      num_images: 1,
    }),
  }
).then(response => response.json());
// Store job.request_id, job.status_url and job.response_url.

正式使用前

• API 密钥保留在服务端，不进入客户端代码。
• 校验提示词长度、文件类型、大小与模型 ID。
• 每次请求绑定用户，并保护状态查询和下载接口。
• 提交前限制额度，重试应具备幂等性。
• 下载需要保留的结果，托管图片链接可能过期。

查看供应商最新文档

Ideogram 官方 API 概览
fal 生成接口格式
fal 编辑接口格式

费用随供应商和质量档位变化，估算成本前请查看最新价格。本站公开预览使用低档质量。

接口信息核对日期为 2026 年 10 月 8 日。本页介绍第三方 API，本站不销售 API 访问权限。