✦图像 API已上线

ideogram-v4 API

Ideogram V4 已通过 API in One 接入真实生产路由 /api/v1/images/generations，后端节点为 node63。一个 API Key 即可调用并按成功请求计费。

真实路由数1当前模型关联的真实端点行。

同端点模型12共享该 endpoint 的已上线模型。

基础成本12 积分$0.12 · 3–12 seconds

端点族图像 API/api/v1/images/generations

获取 API Key 查看文档

Model IDideogram-v4

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型：text

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 webhook。

服务亮点

用市场页形式展示真实已接入能力，不复用外部平台的 SLA、折扣或账号流程。

真实生产路由

当前页面只展示已在 /api/v1 中实现的端点。 /api/v1/images/generations

同步响应

该模型直接返回响应，不需要创建媒体任务。

共享计费系统

充值、订单、积分余额和个人资料继续使用现有共享控制台与旧逻辑。

上游凭据托管

浏览器只持有 API in One Key，上游 Provider 调用由服务端处理。

调用契约

复制这些字段即可接入当前真实模型路由。

Base URL: https://apiin.one
鉴权: Authorization: Bearer <API_KEY>
Model 字段: ideogram-v4
结果查询: /api/v1/tasks/{task_id}
计费入口: /billing/credits

运行方式

该模型创建异步任务，返回 task_id 后通过真实状态接口取回结果。

Client request/api/v1/images/generationstask_id → result

查看使用日志

API Console

像模型市场一样直接切换同端点真实模型、端点和语言，右侧示例由当前 live catalog 的 payload 生成。

真实模型12 个已上线模型

端点1 路由

供应商Ideogramhttps://n63.gogloai.com

当前成本12 积分 · $0.1212 credits per image (~$0.12)

运行方式异步任务异步任务返回 task_id 后查询。

输入 / 输出text -> image该模型直接返回响应，不需要创建媒体任务。

后端节点node63浏览器只持有 API in One Key，上游 Provider 调用由服务端处理。

请求预览POST /api/v1/images/generations

curl --request POST \
  --url https://apiin.one/api/v1/images/generations \
  --header 'Authorization: Bearer <API_KEY>'
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "ideogram-v4",
  "prompt": "A clean editorial poster reading \"SUMMER DESIGN WEEK\", bold typography, warm daylight, modern layout",
  "resolution": "1k",
  "aspect_ratio": "1:1",
  "quality": "medium",
  "output_format": "png"
}'

结果路径/api/v1/tasks/{task_id}

打开文档

端点评估

基于当前真实 endpoint 下的已上线模型，快速判断成本、供应商覆盖和生产接入方式。

同端点模型12使用同一个 BFF 路由，可通过 model 字段切换。

供应商覆盖10当前 endpoint 下的真实供应商来源。

成本区间2-25 积分$0.02-$0.25 · 按当前 live catalog 的基础积分估算。

Webhook 覆盖5/12支持 callback_url 的模型数量。

当前模型位置10/12

按基础积分从低到高排序。

当前 endpoint 低成本模型ideogram-v4-edit

Ideogram · 2 积分 · $0.02

生产接入方式异步任务 + 状态查询

异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果；对话模型直接返回响应。

真实能力

以下能力来自当前已接入的模型配置和后端路由，不展示未上线 API。

稳定生产路由

Strong typography and design output

统一接口

Flexible aspect ratios and 1K/2K resolution tiers

透明计费

Low, medium, and high quality tiers

快速接入

PNG, JPEG, and WEBP output

请求方式

浏览器端只调用同源 API，服务端 BFF 再转发到对应 Worker。

方法端点积分用途

POST/api/v1/images/generations12 积分

Ideogram V4 — high-quality text-to-image generation with strong typography, flexible aspect ratios, resolution tiers, and quality controls.

参数

promptstring

Text description of the image

必填

modelstring

Use "ideogram-v4"

必填 · 默认 ideogram-v4

resolutionstring

Output resolution: 1k or 2k

可选 · 默认 1k

aspect_ratiostring

Output aspect ratio: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 9:21, 21:9

可选 · 默认 1:1

qualitystring

Quality tier: low, medium, high

可选 · 默认 medium

output_formatstring

Output format: png, jpeg, webp

可选 · 默认 png

示例请求

curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "ideogram-v4",
  "prompt": "A clean editorial poster reading \"SUMMER DESIGN WEEK\", bold typography, warm daylight, modern layout",
  "resolution": "1k",
  "aspect_ratio": "1:1",
  "quality": "medium",
  "output_format": "png"
}'