✦图像 API已上线

ideogram-v4 API

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

获取 API Key 查看文档

Model IDideogram-v4

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型：text

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 webhook。

真实能力

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

稳定生产路由

Strong typography and design output

统一接口

Flexible size presets

透明计费

Turbo, Default, and Quality rendering modes

快速接入

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 sizes, and speed-quality controls.

参数

promptstring

Text description of the image

必填

modelstring

Use "ideogram-v4"

必填 · 默认 ideogram-v4

sizestring

Size: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 9:21, 21:9

可选 · 默认 1:1

rendering_speedstring

Rendering speed: TURBO, BALANCED, QUALITY

可选 · 默认 BALANCED

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",
  "size": "1:1",
  "rendering_speed": "BALANCED",
  "output_format": "png"
}'

同端点可切换模型

这些模型使用同一个已实现 BFF endpoint，可通过请求体中的 model 字段切换。

🧠cogview-4image · 4 积分/api/v1/images/generations

flux-2image · 5 积分/api/v1/images/generations

grok-imagineimage · 5 积分/api/v1/images/generations

kling-image-o1image · 6 积分/api/v1/images/generations✦ideogram-v3image · 8 积分/api/v1/images/generations🌐imagen-4image · 8 积分/api/v1/images/generations

接入流程

这些步骤基于当前真实路由和共享账号体系，不新增独立登录、支付或订单流程。

创建共享 API Key

在现有 Dashboard 创建密钥，充值、订单、积分和个人信息仍走共享控制台。

调用真实端点

使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/images/generations

查询任务状态

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

任务状态查询

图像、视频、音频和工具任务创建后，使用真实任务端点查询结果。

GET/api/v1/tasks/{task_id}查询生成任务状态和结果。

价格

12 credits per image (~$0.12)

基础价格$0.12

积分12

计费按成功请求

使用场景

这些场景可通过当前模型和对应后端节点实现。

Create posters and social graphics with accurate text

Generate brand and campaign concepts

Build AI design tools with typography-friendly output

Produce multiple aspect ratios from one prompt

常见问题

How much does Ideogram V4 cost?

Ideogram V4 currently costs 12 credits per image (~$0.12) through the node63 backend.

What sizes are supported?

Supported sizes include 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 9:21, and 21:9.

Which output formats are supported?

PNG, JPEG, and WEBP output formats are supported.