- 1K
- FAL ≈$0.025 / 张
- 2K
- FAL ≈$0.10 / 张
价格比较
同一输出规格,比较各渠道公开价
计价说明
按实际执行渠道计费;故障转移时可能切换渠道,费用和耗时随之变化。
API 接入
交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。
让编码 Agent 接入
复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。
添加 Yir MCP 服务器
接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 Krea 3;它会先报价,你确认后才生成。
https://gateway.yir.ai/mcpClaude Code 一行命令
先在控制台创建 API Key 并设为环境变量 YIR_API_KEY,再运行:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"安装 Yir Skill
在 Agent 运行环境里设好 YIR_API_KEY,装进 Claude Code、Codex 等编码 Agent 后,直接说“用 Yir 的 Krea 3 生成……”。
npx skills add yir-ai/skills通过包管理器安装官方 SDK,或直接复制下方代码进行集成
| // Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL. |
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // 默认从环境变量读取 YIR_API_KEY: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. 提交图片生成任务 |
| const job = await client.submitImage({ |
| model: "krea/krea-3", |
| input: { |
| type: "image", |
| prompt: "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签", |
| references: [{ role: "reference_image", ...{ url: "https://example.com/your-reference-image.png" } }], |
| }, |
| parameters: { |
| resolution: "1K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. 等待任务完成并交付结果 |
| const result = await client.waitForJob(job.id); |
| console.log("交付文件:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
已按 OpenAI 协议对接的项目,或 new-api 等网关,只需更换 Base URL 和 Key。 OpenAI 兼容说明
- OpenAI SDK base_url
https://gateway.yir.ai/openai/v1- new-api 渠道 Base URL
https://gateway.yir.ai/openai- 密钥
- Yir API Key
- 模型 ID
krea/krea-3
# Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL.
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "krea/krea-3",
"prompt": "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
"resolution": "1K",
"aspect_ratio": "1:1",
"images": [
{
"image_url": "https://example.com/your-reference-image.png"
}
]
}'参数概览
常用参数,具体限制以当前模型及所选渠道为准
- 分辨率 resolution
- 1K
- 2K
成图或成片的分辨率档位,更高规格拥有更多像素细节,按档位计费
- 宽高比 aspect_ratio
- 1:1
- 4:3
- 3:4
- 16:9
- 9:16
画面几何比例,建议依据展示媒介(手机竖屏、横屏横幅或方形)指定
- 输入方式 input_mode
- 图片输入
参考素材的数量与格式以当前模型及所选渠道支持范围为准
- 参考素材 references
- reference_image ≤ 8
各输入方式下的参考素材数量上限,以所选渠道为准;价格表中的数量仅为计价示例,不代表支持上限或免费额度
常见问题
价格因渠道、分辨率和画质而不同。上方比价表按同一输出规格列出各渠道公开价;按 Token 计费的渠道显示输出估算,不含输入费用。通过 Yir 调用时按实际执行渠道的公开价收取,不加价。
比价表按代表输出规格组织渠道价格。只有费用覆盖、计价单位和适用条件一致时,单价才可直接比较;输出估算仅供参考,不包含另计的输入费用,也不保证跨渠道像素或画质等价。请查看价格明细及分辨率、画质和参考图限制;通过 Yir 调用时,会在你的预算和渠道设置内选择当前合格的渠道。
不会:每个任务按实际执行渠道的公开价收取,不加价;钱包充值 US$100 起免手续费,低于 US$100 另收 5%(最低 US$0.50)。上游未计费的尝试和 Yir 自身的交付失败不收费;失败时路由自动换渠道,省去自己重试的成本。
创建 Yir API Key 后,通过 Yir API 提交生成任务并获取结果。上方「API 接入」提供可直接复制的示例代码,参数可在调试台中调整。





