--- title: 在 WorkBuddy 中通过 RunAPI 使用 Ideogram V3 — MCP 指南 | RunAPI description: 在 WorkBuddy 中通过 RunAPI 使用 Ideogram V3 生成具有一流文字排版的图像。添加一个 MCP 服务器，工作台即可直接调用文生图、编辑和混合工具。 url: https://runapi.ai/zh-CN/workbuddy-ideogram-v3.md canonical: https://runapi.ai/zh-CN/workbuddy-ideogram-v3 locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-ideogram-v3 zh-CN: https://runapi.ai/zh-CN/workbuddy-ideogram-v3 es: https://runapi.ai/es/workbuddy-ideogram-v3 ja: https://runapi.ai/ja/workbuddy-ideogram-v3 de: https://runapi.ai/de/workbuddy-ideogram-v3 fr: https://runapi.ai/fr/workbuddy-ideogram-v3 pt-BR: https://runapi.ai/pt-BR/workbuddy-ideogram-v3 ko: https://runapi.ai/ko/workbuddy-ideogram-v3 it: https://runapi.ai/it/workbuddy-ideogram-v3 nl: https://runapi.ai/nl/workbuddy-ideogram-v3 pl: https://runapi.ai/pl/workbuddy-ideogram-v3 tr: https://runapi.ai/tr/workbuddy-ideogram-v3 zh-TW: https://runapi.ai/zh-TW/workbuddy-ideogram-v3 zh-HK: https://runapi.ai/zh-HK/workbuddy-ideogram-v3 ar: https://runapi.ai/ar/workbuddy-ideogram-v3 x-default: https://runapi.ai/workbuddy-ideogram-v3 model: ideogram-v3 --- > HTML version: https://runapi.ai/zh-CN/workbuddy-ideogram-v3 > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Ideogram V3 Ideogram V3 生成的图像具有行业领先的文本渲染能力 — 在海报、logo 和标识上呈现其他图像模型难以胜任的可读排版。它提供三个端点（text_to_image、edit_image、remix_image）和一个 turbo 速度层级，能以更低成本将生成时间缩短一半。WorkBuddy 通过 runapi MCP 服务器调用它 — 模型以可调用工具的形式出现在工作台中，无需安装任何插件。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 排版优先生成 · turbo 速度层级 ### Prompt ```text 通过 runapi MCP 服务器使用 Ideogram V3 生成一张文字渲染准确的海报。 要求： - 调用 runapi MCP 服务器提供的图像生成工具。 - 将 model 设为 "ideogram-v3-text-to-image"。 - Prompt: "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones." - 将 style 设为 design，aspect_ratio 设为 3:4。 - 可选：将 rendering_speed 设为 turbo 以加快生成，或设为 quality 以获得最佳效果。 - 等待任务完成后返回输出图像 URL。 ``` ### MCP 配置 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```json { "task_id": "tsk_abc123", "status": "completed", "model": "ideogram-v3-text-to-image", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png" } } ``` ## 三步在 WorkBuddy 中使用 Ideogram V3 1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，使用 streamable HTTP 传输，并让 Authorization 头从 RUNAPI_API_KEY 环境变量读取密钥。如果已经为其他模型连接过 RunAPI，同一个服务器即可覆盖 Ideogram V3 — 无需额外配置。 `url: https://runapi.ai/mcp` 2. **向工作台 agent 下达提示词** - 让 WorkBuddy 以 ideogram-v3-text-to-image 为 model 生成图像，并在提示词中写明你希望在图像中渲染的具体文字。海报和 logo 工作将 style 设为 design，照片级输出设为 realistic。使用 rendering_speed turbo 可以更低成本更快出图。 `用 Ideogram V3 生成一张海报` 3. **获取结果** - WorkBuddy 调用 RunAPI MCP 工具，生成以异步任务的方式执行，状态轮询由服务器代为处理。任务完成后，agent 会把输出图像 URL 直接汇报到工作台中。使用 output_count 每次调用最多可请求 4 张图像。 `task_id: tsk_abc123` ## Ideogram V3 API 参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。ideogram-v3-text-to-image、ideogram-v3-edit 或 ideogram-v3-remix。 | | `prompt` | `string` | 所需图像的文本描述。包含你希望渲染的具体文字。 | | `style` | `string` | 可选。auto、general、realistic 或 design。海报和 logo 请使用 design。 | | `rendering_speed` | `string` | 可选。turbo（最快，成本最低）、balanced（默认）或 quality（细节最高）。 | | `aspect_ratio` | `string` | 可选。1:1、3:4、9:16、4:3 或 16:9。 | | `source_image_url` | `string` | edit 和 remix 端点必填。源图像的 URL。 | ## WorkBuddy 上的 Ideogram V3 是什么？ Ideogram V3 是图像生成文字排版领域的领先模型，能精准呈现清晰专业的文字，在一两次尝试内达到 90-95% 的文字准确率，并支持风格参考以保持品牌一致性。WorkBuddy 通过 runapi MCP 服务器调用它，使用覆盖目录中所有模型的同一个 RUNAPI_API_KEY。 ## Ideogram V3 使用场景 - **Logo 与品牌视觉探索** - 让工作台 agent 生成公司名称渲染准确的 logo 概念图，为品牌识别工作探索多个视觉方向，无需手动排版文字。 - **视频封面与社交媒体图** - 制作抓眼球的视频封面、Pinterest 图钉和社交媒体配图，醒目可读的文字首次生成即可正确呈现。 - **产品效果图与电商列表** - 直接从 WorkBuddy 任务生成带准确标签、价格文字和功能标注的产品效果图，用于客户演示或电商产品页面。 ## Ideogram V3 + WorkBuddy 常见问题 ### 如何在 WorkBuddy 中使用 Ideogram V3？ 在 WorkBuddy 中添加一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp 并携带你的 RUNAPI_API_KEY，然后让工作台 agent 以 ideogram-v3-text-to-image 为 model 生成图像。agent 会调用 RunAPI MCP 工具并返回完成的图像 URL — 无需插件或单独账户。 ### 与其他模型相比，Ideogram V3 如何处理图像中的文本？ Ideogram V3 专门针对排版渲染进行了优化。它能生成可读的多行文本、风格化标题以及 logo 级别的字体，而 Flux 或 Imagen 等模型常常会将其弄乱。如果你的用例需要在海报、标识或产品标签上呈现准确文本，Ideogram V3 是 RunAPI 目录中最强的选择。 ### turbo、balanced 和 quality 渲染速度有什么区别？ Turbo 生成最快，成本约为 balanced 的一半。Quality 生成细节最高但耗时更长。Balanced 是默认的折中选项。三个层级都使用同一个底层 Ideogram V3 模型 — 区别在于计算时间和保真度，而非模型版本。 ### 可以在 WorkBuddy 中编辑或混合现有图像吗？ 可以。同一个 runapi MCP 服务器还提供 edit_image 工具（配合 ideogram-v3-edit，在文本提示词引导下修改源图像）和 remix_image 工具（配合 ideogram-v3-remix，将源图像的风格迁移到新构图上）。两者都需要 source_image_url 作为参数。 ### Ideogram V3 是异步的吗？等待过程需要我自己处理吗？ 生成以异步任务的方式执行并返回一个 task_id。RunAPI MCP 服务器会代为处理状态轮询，任务完成后 WorkBuddy agent 直接汇报输出 URL。每张生成的图像单独计费，失败的生成不收费。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未配置？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Ideogram V3 模型 →](https://runapi.ai/zh-CN/models/ideogram-v3.md) - 查看所有 Ideogram V3 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 Ideogram V3。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，即可使用 Ideogram V3 生成具有准确排版的图像。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI Ideogram V3", "applicationCategory": "DeveloperApplication", "description": "在 WorkBuddy 中通过 RunAPI 使用 Ideogram V3 生成具有一流文字排版的图像。添加一个 MCP 服务器，工作台即可直接调用文生图、编辑和混合工具。", "url": "https://runapi.ai/zh-CN/workbuddy-ideogram-v3" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "如何在 WorkBuddy 中使用 Ideogram V3？", "acceptedAnswer": { "@type": "Answer", "text": "在 WorkBuddy 中添加一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp 并携带你的 RUNAPI_API_KEY，然后让工作台 agent 以 ideogram-v3-text-to-image 为 model 生成图像。agent 会调用 RunAPI MCP 工具并返回完成的图像 URL — 无需插件或单独账户。" } }, { "@type": "Question", "name": "与其他模型相比，Ideogram V3 如何处理图像中的文本？", "acceptedAnswer": { "@type": "Answer", "text": "Ideogram V3 专门针对排版渲染进行了优化。它能生成可读的多行文本、风格化标题以及 logo 级别的字体，而 Flux 或 Imagen 等模型常常会将其弄乱。如果你的用例需要在海报、标识或产品标签上呈现准确文本，Ideogram V3 是 RunAPI 目录中最强的选择。" } }, { "@type": "Question", "name": "turbo、balanced 和 quality 渲染速度有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "Turbo 生成最快，成本约为 balanced 的一半。Quality 生成细节最高但耗时更长。Balanced 是默认的折中选项。三个层级都使用同一个底层 Ideogram V3 模型 — 区别在于计算时间和保真度，而非模型版本。" } }, { "@type": "Question", "name": "可以在 WorkBuddy 中编辑或混合现有图像吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。同一个 runapi MCP 服务器还提供 edit_image 工具（配合 ideogram-v3-edit，在文本提示词引导下修改源图像）和 remix_image 工具（配合 ideogram-v3-remix，将源图像的风格迁移到新构图上）。两者都需要 source_image_url 作为参数。" } }, { "@type": "Question", "name": "Ideogram V3 是异步的吗？等待过程需要我自己处理吗？", "acceptedAnswer": { "@type": "Answer", "text": "生成以异步任务的方式执行并返回一个 task_id。RunAPI MCP 服务器会代为处理状态轮询，任务完成后 WorkBuddy agent 直接汇报输出 URL。每张生成的图像单独计费，失败的生成不收费。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何在 WorkBuddy 中通过 RunAPI 使用 Ideogram V3", "description": "在 WorkBuddy 中添加 RunAPI MCP 服务器，然后向工作台 agent 下达提示词，即可使用 Ideogram V3 生成具有准确排版的图像。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，使用 streamable HTTP 传输，并让 Authorization 头从 RUNAPI_API_KEY 环境变量读取密钥。如果已经为其他模型连接过 RunAPI，同一个服务器即可覆盖 Ideogram V3 — 无需额外配置。", "url": "https://runapi.ai/zh-CN/workbuddy-ideogram-v3#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台 agent 下达提示词", "text": "让 WorkBuddy 以 ideogram-v3-text-to-image 为 model 生成图像，并在提示词中写明你希望在图像中渲染的具体文字。海报和 logo 工作将 style 设为 design，照片级输出设为 realistic。使用 rendering_speed turbo 可以更低成本更快出图。", "url": "https://runapi.ai/zh-CN/workbuddy-ideogram-v3#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "获取结果", "text": "WorkBuddy 调用 RunAPI MCP 工具，生成以异步任务的方式执行，状态轮询由服务器代为处理。任务完成后，agent 会把输出图像 URL 直接汇报到工作台中。使用 output_count 每次调用最多可请求 4 张图像。", "url": "https://runapi.ai/zh-CN/workbuddy-ideogram-v3#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI Ideogram V3", "item": "https://runapi.ai/zh-CN/workbuddy-ideogram-v3" } ] } ] ```