一个标准接口，
接入持续扩展的模型。

1. 打开“模型服务”，新增 OpenAI Compatible，不要选择只能官方登录的提供商。
2. API Host / API 地址填 Origin https://api.wanchuanapi.com，不要追加 /v1；API Key 填客户专属 Key。
3. 手动添加 GET /v1/models 返回的精确模型 ID。
4. 保存后检查连接测试或网络日志：模型目录最终路径必须是 /v1/models，聊天最终路径必须是 /v1/chat/completions；若缺少 /v1 或出现 /v1/v1，停止使用并先确认客户端版本的 URL 拼接规则。

1. 打开“模型提供方”，新增自定义 OpenAI-compatible Provider。
2. API Host / Base URL 填 https://api.wanchuanapi.com/v1，API Path 填 /chat/completions。
3. 填客户专属 Key，并手动添加 GET /v1/models 返回的精确模型 ID。
4. 保存后确认最终请求必须是 https://api.wanchuanapi.com/v1/chat/completions，再到控制台核对请求记录。

1. 下载万川客户端配置包，按对应应用模板新增名为“万川 API”的 Provider。
2. Base URL 填 https://api.wanchuanapi.com/v1；Key 只保存在服务器端配置。
3. 刷新模型目录；若应用不自动加载，就手动添加精确模型 ID。
4. 重启或保存连接后发起最小对话，确认实际 Host 与控制台记录都属于万川。

1. 下载万川客户端配置包并使用其中的 LobeChat 模板。
2. 模板把 OPENAI_PROXY_URL 指向 https://api.wanchuanapi.com/v1，Key 只通过服务端环境变量注入。
3. 按模型白名单只开放当前账号返回的精确模型 ID。
4. 这会把 LobeChat 的内置 OpenAI 槽位重定向到万川，不是新增独立 Provider；界面和内部 Provider ID 仍可能显示 OpenAI。发起最小对话后仍须确认实际 Host 与控制台记录属于万川。

1. 进入“设置 → 模型供应商”，选择支持自定义地址的 OpenAI Compatible 提供商。
2. 填写 https://api.wanchuanapi.com/v1 和专属 Key。
3. 点“添加模型”，粘贴精确 ID；聊天模型选 LLM，向量模型选 Embedding。
4. 在应用编排页选择该模型并运行一次；两边账本会分别记录。

1. 下载图片生视频工作流或下载视频生视频工作流，导入后先保持未激活；需要主动释放配额时另行下载显式删除输入工作流。
2. 在 n8n 凭据库新建 Bearer Header Auth；下载文件不含 Key。
3. 图片工作流上传 PNG/JPEG/WebP，平台不设置单张图片独立字节上限；图片与视频共同占用每账户 10 GiB 输入配额。视频工作流要求预先转为 H.264 MP4，视频单文件上限为 500 MiB、时长 1–30 秒、最大 3840×2160，所选上游模型仍可能有更小的能力限制。大视频须使用 n8n filesystem 或企业 external binary 模式，避免 Code 节点全量载入内存。两种素材都直接上传万川 /v1/media/inputs，再用返回的不透明输入 ID 创建并轮询任务。
4. 输入达到 ready 后一直保留到显式调用 DELETE /v1/media/inputs/{input_id}；仍被活动媒体任务引用时不能删除。
5. 示例客户逻辑模型为 bytedance/seedance-2.5-high-speed；仍须以 GET https://api.wanchuanapi.com/v1/media/models 返回为准，不要填上游请求 ID。

安装后显示“万川 API｜图片生视频”“万川 API｜视频生视频”和“万川 API｜手动删除媒体输入（仅用户触发）”。三个节点都只连接万川媒体接口，不连接 ComfyUI 官网或 ByteDance 官方节点；只有厂商 Key 输入框、不能修改请求地址的节点仍会绕过万川。

1. 下载 ComfyUI 万川节点包，解压到 ComfyUI/custom_nodes，并确认最终路径为 ComfyUI/custom_nodes/comfyui-wanchuan/__init__.py 后重启。
2. 把 Key 注入 ComfyUI 进程环境变量 WANCHUAN_API_KEY；节点没有 Key 输入框，工作流 JSON 不保存 Key。
3. 图片生视频连接官方 Load Image；视频生视频连接官方 Load Video 的 VIDEO 输出，节点在本地转为 H.264 MP4 后直传万川 /v1/media/inputs。
4. 生成节点会在旧的三个结果之后追加万川 input ID；只有用户连接该 ID、明确确认并运行删除节点时才会删除。若上传后任务创建、轮询或下载失败，错误信息会列出仍保留的 input ID，便于之后手动清理。
5. 示例客户逻辑模型为 bytedance/seedance-2.5-high-speed；仍须以 GET https://api.wanchuanapi.com/v1/media/models 返回为准并确认对应媒体能力，不要填上游请求 ID。

POST https://api.wanchuanapi.com/v1/media/jobs
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"model":"bytedance/seedance-2.5-high-speed","prompt":"保持商品外观，镜头缓慢环绕","parameters":{"input_asset_ids":["INPUT_ASSET_ID"],"duration":5,"resolution":"480p","aspect_ratio":"16:9","provider_processing_acknowledged":true}}

GET https://api.wanchuanapi.com/v1/media/jobs/JOB_ID
Authorization: Bearer YOUR_API_KEY

1. 查找 OpenAI Compatible、Custom OpenAI 或 Base URL 设置。
2. 能同时自定义 URL、Authorization Header 和 Model 时直接填写统一信息。
3. 没有这些字段时改用 HTTP/API 工具；不能自定义 Header 的平台不能安全直连。
4. Key 必须保存在平台的凭据库，不要写入公开模板。

1. 把 Key 放在服务端环境变量或密钥管理器，不要写死在代码中。
2. OpenAI SDK 的 base_url 设为 https://api.wanchuanapi.com/v1。
3. 先列出模型，再按 Chat、Embedding 或 Media 接口调用。
4. 生产环境配置超时、幂等键、有限重试和脱敏日志；401/403 不应自动重试。

1. 确认当前版本明确支持第三方 Base URL 和 OpenAI 兼容协议。
2. 只接受官方登录或厂商原生协议时，不能用万川 Key 替换。
3. 不要修改 hosts、注入证书或使用来源不明的代理强行接管流量。

1. 它是通过公开 REST 接口执行指定动作，不是把万川设置成 ChatGPT 的底层模型。
2. 使用公开 OpenAPI 文档声明需要的端点，并按连接器要求保存认证。
3. 只开放业务所需的最小接口，不在提示词或共享 GPT 中写入长期 Key。