变体 · Ideogram / Ideogram V3

ideogram-v3-text-to-image API

Ideogram / Ideogram V3

通过 RunAPI 使用 Ideogram V3 系列的 ideogram-v3-text-to-image。按次计费,无需订阅,失败的生成不计费。

运行中 · image · 可商用
runapi.ai
curl -X POST https://runapi.ai/api/v1/ideogram_v3/text_to_image \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v3-text-to-image",
  "prompt": "创建一张电影海报,标题 '最后的边疆' 用粗体衬线字在顶部,背景是太空站。"
}'
import { IdeogramV3Client } from "@runapi.ai/ideogram-v3";

const client = new IdeogramV3Client();
const result = await client.textToImage.run({
    model: "ideogram-v3-text-to-image",
    prompt: "创建一张电影海报,标题 '最后的边疆' 用粗体衬线字在顶部,背景是太空站。",
});
<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\IdeogramV3\IdeogramV3Client;

$client = new IdeogramV3Client();
$result = $client->textToImage->run([
        'model' => 'ideogram-v3-text-to-image',
        'prompt' => '创建一张电影海报,标题 \'最后的边疆\' 用粗体衬线字在顶部,背景是太空站。',
]);
require "runapi/ideogram_v3"

client = RunApi::IdeogramV3::Client.new
result = client.text_to_image.run(
    model: "ideogram-v3-text-to-image",
    prompt: "创建一张电影海报,标题 '最后的边疆' 用粗体衬线字在顶部,背景是太空站。"
)
npx skills add runapi-ai/ideogram-v3 -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
@runapi.ai/ideogram-v3 v1
切换变体
概览

ideogram-v3-text-to-image 在 Ideogram V3 家族中处于质量与成本的最佳平衡点。

  • USD 按次定价
  • 失败不计费
  • 模型支持时流式
  • Schema 校验后的工具调用
定价

定价

失败的生成不计费
Text to image
$0.04-$0.10 / image
Rendering speed: turbo $0.04
Rendering speed: quality $0.10
Rendering speed: balanced $0.07
规格

技术细节

模型 ID ideogram-v3-text-to-image
提供方 Ideogram
模态 image
任务类型 asynchronous
计费单位 call
API 端点 /api/v1/ideogram_v3/text_to_image
商用许可 允许商用
状态 运行中
技能

Model skill — ideogram-v3-text-to-image

安装一次 skill,开发时使用本页的变体 ID。

# Install the model skill for app development workflows
npx skills add runapi-ai/ideogram-v3 -g
Installs docs, schemas, pricing context, and setup notes into your developer workspace.
Or use this setup request in your coding tool:
Install the Ideogram V3 skill for this app:

1. Add runapi-ai/ideogram-v3 with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.
工作流程

用 model skill 使用 ideogram-v3-text-to-image

01

安装

安装该模型线对应的 model skill。

02

配置

把 model 字段设置为本页展示的完整模型 ID。

03

调用

按 skill 说明把提示词、输入文件和回调处理接入应用。

04

接收

从 RunAPI 读取任务响应、webhook 回调或缓存输出 URL。

差异

ideogram-v3-text-to-image 与其它变体的差异

VS IDEOGRAM-V3-CHARACTER

约 90–95% 图内文字准确率;最适合排版密集图像

通过一张角色参考图锚定身份的生成

VS IDEOGRAM-V3-CHARACTER-EDIT

约 90–95% 图内文字准确率;最适合排版密集图像

局部重绘时保持参考角色身份一致

VS IDEOGRAM-V3-CHARACTER-REMIX

约 90–95% 图内文字准确率;最适合排版密集图像

结合原图、角色参考与风格参考进行重混

应用场景

最适合的场景

产品摄影

为缺少棚拍照片的电商商品自动生成场景化产品图。

游戏与概念设计

快速概念化环境和角色,再进入最终美术制作。

编辑配图

为博客文章和专栏批量生成独特封面图和插图。

常见问题

ideogram-v3-text-to-image 常见问题

模型 ID 跨版本稳定吗?

RunAPI 保持模型 ID 稳定,并在不改变请求形态的前提下处理兼容版本刷新。

该变体的限流?

Key 级限流随使用层级伸缩。当前限制见定价页。

能切到其它变体吗?

可以——变体只是参数,改 model 字段即可。

支持流式吗?

模型支持流式时,RunAPI 端到端流式。

质量问题在哪里报?

在公共 GitHub 仓库提 issue 或邮件联系 support。

立即开始

立即体验 Ideogram V3。