✦图像 API已上线

ideogram-v3 API

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

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

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

基础成本8 积分$0.08 · 3–8 seconds

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

获取 API Key 查看文档

Model IDideogram-v3

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型：text, image

鉴权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-v3
结果查询: /api/v1/tasks/{task_id}
计费入口: /billing/credits

运行方式

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

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

查看使用日志

API Console

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

真实模型11 个已上线模型

端点1 路由

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

当前成本8 积分 · $0.088–20 credits per image (~$0.08–$0.20)

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

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

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

打开文档

端点评估

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

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

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

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

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

当前模型位置5/11

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

当前 endpoint 低成本模型cogview-4

Zhipu AI / WaveSpeed · 4 积分 · $0.04

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

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

真实能力

以下能力来自当前已接入的模型配置和后端路由，不展示未上线 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"
}'