控制台 ↗
接入与帮助

常见问题

接入地址、权限、文件与结果判定

可以直接把文档地址交给 Agent 吗

可以。/llms-full.txt 和 /yunqi-agent-guide.md 包含完整文档,/models.json 提供模型 ID 和协议。另行指定要使用的模型,并将 Key 配置在 Agent 的安全运行环境中即可。

模型列表里有,为什么请求仍然失败

模型列表只列目录和权限。调用时还会检查渠道、预算、并发、字段和输入格式,具体原因见错误正文。出错后保留原模型 ID 排查。

Base URL 要不要带 /v1

OpenAI SDK 和 Codex 带 /v1,Anthropic SDK 和 Claude Code 不带。原生 Gemini 与 Realtime 使用各自路径,具体见快速开始的地址表。

参考图是原生图生图吗

是。Images edits 通过 image / image[] 上传文件,Gemini 通过 inlineData 传入图片,MJ 使用图片 URL 语法。Base64 只是图片的编码方式,应放入协议规定的图片字段,而非普通提示词。

多张参考图能否单独引用

可以,分别上传后在提示词中说明顺序或各图用途。Images 的 mask 作用于第一张图,Gemini 每张图使用独立 part,MJ 的普通垫图、sref、cref、oref 则按版本使用。各协议的参数格式不同。

能否上传大视频或任意文件

Gemini 文本多模态型号支持本版列出的内联媒体格式。大文件受编码体积和上下文限制,通用 Files API 不在支持范围内。Word、Excel 和压缩包的处理方式见文件与媒体。

下线型号怎么办

gpt-image-2-each 已从可调用目录和示例中移除。glm-5.2 已灰度下线,如有需要请联系商务。需要更换型号时,请重新指定完整模型 ID。

YunQi AI 开放平台文档 · 客户接入与参数参考文档更新于 2026-10-23 · v1.1.0