Update nexus wiki content
This commit is contained in:
51
wiki/concepts/多Provider图像生成.md
Normal file
51
wiki/concepts/多Provider图像生成.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
title: "多Provider图像生成"
|
||||
type: concept
|
||||
tags: []
|
||||
sources: [baoyu-skills]
|
||||
last_updated: 2026-04-19
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
多 Provider 图像生成是 [[baoyu-imagine]] 技能的核心架构——通过统一接口封装多个图像生成服务商,实现 provider 自动选择和环境变量配置管理,用户无需关心底层服务商细节。
|
||||
|
||||
## Supported Providers
|
||||
|
||||
| Provider | API | 模型 | 特色 |
|
||||
| --- | --- | --- | --- |
|
||||
| OpenAI | `OPENAI_API_KEY` | gpt-image-1.5 | 主流,质量稳定 |
|
||||
| Google | `GOOGLE_API_KEY` | gemini-3-pro-image-preview | 高质量 |
|
||||
| Azure OpenAI | `AZURE_OPENAI_API_KEY` | 可配置部署名 | 企业级 |
|
||||
| OpenRouter | `OPENROUTER_API_KEY` | google/gemini-3.1-flash-image-preview | 统一网关 |
|
||||
| DashScope(阿里通义万相) | `DASHSCOPE_API_KEY` | qwen-image-2.0-pro | 中文优化,支持 21:9 |
|
||||
| Z.AI | `ZAI_API_KEY` | glm-image | 海报/图表,中英文 |
|
||||
| MiniMax | `MINIMAX_API_KEY` | image-01 | 低延迟,支持参考图 |
|
||||
| 即梦(Jimeng) | 火山引擎 Key | jimeng_t2i_v40 | 国内直达 |
|
||||
| 豆包(Seedream) | ARK API Key | doubao-seedream-5-0-260128 | 参考图能力强 |
|
||||
| Replicate | `REPLICATE_API_TOKEN` | google/nano-banana-2 | nano-banana 系列 |
|
||||
|
||||
## Auto-Selection Logic
|
||||
|
||||
1. 显式指定 `--provider` → 使用指定的
|
||||
2. 传入 `--ref` 参考图且未指定 provider → 依次尝试 Google、OpenAI、Azure、OpenRouter、Replicate、Seedream、MiniMax
|
||||
3. 只有一个 API 密钥 → 使用对应服务商
|
||||
4. 多个可用 → 默认优先级:Google > OpenAI > Azure > OpenRouter > DashScope > Z.AI > MiniMax > Replicate > 即梦 > 豆包
|
||||
|
||||
## Configuration Hierarchy
|
||||
|
||||
环境变量通过四层加载(高优先级覆盖低优先级):
|
||||
1. 命令行环境变量
|
||||
2. `process.env`(系统环境变量)
|
||||
3. `~/.baoyu-skills/.env`(用户级)
|
||||
4. `<cwd>/.baoyu-skills/.env`(项目级)
|
||||
|
||||
## Key Design Decisions
|
||||
|
||||
- `--model` 参数在 Azure 表示 deployment name(不是底层模型家族名)
|
||||
- 参考图能力因 provider 而异:Google/OpenAI/Azure/OpenRouter/Replicate/MiniMax/Seedream 5.0/4.5/4.0 支持;即梦不支持
|
||||
- Replicate 只保存单张输出图,`--n > 1` 会本地报错避免结果静默丢弃
|
||||
|
||||
## Connections
|
||||
- [[baoyu-imagine]] ← implements ← 多Provider图像生成
|
||||
- [[baoyu-skills]] ← 包含 ← 多Provider图像生成
|
||||
Reference in New Issue
Block a user