✦图像 API已上线

ideogram-v3 API

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

获取 API Key 查看文档

Model IDideogram-v3

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型：text, image

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 webhook。

真实能力

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

稳定生产路由

Best-in-class typography rendering

统一接口

3 quality tiers (turbo/balanced/quality)

透明计费

Image editing with mask support

快速接入

Reference image input for style control

请求方式

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

方法端点积分用途

POST/api/v1/images/generations8 积分

Ideogram V3 — industry-leading text-to-image generation with best-in-class typography and design capabilities.

参数

promptstring

Text description of the image

必填

modelstring

Sub-model: "ideogram-v3-turbo" (8cr), "ideogram-v3-balanced" (13cr), or "ideogram-v3-quality" (20cr)

可选 · 默认 ideogram-v3-turbo

aspect_ratiostring

Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4

可选 · 默认 1:1

stylestring

Style preset: "Auto", "General", "Realistic", "Design"

可选 · 默认 Auto

imagestring

Input image URL for editing

可选

mask_imagestring

Mask image URL for inpainting

可选

reference_imagesarray

Array of reference image URLs for style guidance

可选

示例请求

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-v3-turbo",
  "prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
  "aspect_ratio": "3:4",
  "style": "Design"
}'

同端点可切换模型

这些模型使用同一个已实现 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🌐imagen-4image · 8 积分/api/v1/images/generations🤖gpt-image-1.5-officialimage · 10 积分/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}查询生成任务状态和结果。

价格

8–20 credits per image (~$0.08–$0.20)

基础价格$0.08

积分8

计费按成功请求

使用场景

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

Create social media graphics with embedded text

Generate poster and flyer designs

Build AI design tools for non-designers

Produce brand assets with accurate typography

常见问题

How much does Ideogram V3 cost?

Depends on sub-model: turbo costs 8 credits, balanced costs 13 credits, quality costs 20 credits per image.

What makes Ideogram V3 special?

Ideogram V3 is widely regarded as the best model for generating images with accurate text and typography.

Does it support image editing?

Yes. Provide an input image and optional mask_image for inpainting and editing.

What styles are available?

Supported styles: Auto, General, Realistic, and Design.