接入说明YunQi API
调用格式速查
YunQi 各协议的请求路径与媒体字段
按场景选择接口
调用时使用下表中的 YunQi 接口路径，并填写 GET /v1/models 返回的完整模型 ID。
| 调用场景 | 接口 | 关键写法 | 适用模型 |
|---|---|---|---|
| 获取模型列表 | GET /v1/models | Bearer API Key | 当前 API Key 可调用的模型 |
| OpenAI 对话 | POST /v1/chat/completions | messages | GPT、Claude、Gemini 文本模型 |
| Responses | POST /v1/responses | input | GPT 系列 |
| Anthropic Messages | POST /v1/messages | messages + max_tokens | Claude 系列 |
| Gemini 多模态与生图 | POST /v1beta/models/{model}:generateContent | contents[].parts | Gemini 系列与 Gemini Image |
| OpenAI 图像生成 | POST /v1/images/generations | prompt + size | gpt-image-2-each、gpt-image-2 |
| OpenAI 图像编辑 | POST /v1/images/edits | multipart/form-data | gpt-image-2-each、gpt-image-2 |
三种协议的 Base64 写法
| 协议 | 输入字段 | 传值形式 | 输出图片字段 |
|---|---|---|---|
| OpenAI Responses | input_image.image_url | data:image/png;base64,... | 视觉理解返回文本 |
| OpenAI Images | image | 编辑接口上传 multipart 文件 | data[].b64_json 或 data[].url |
| Anthropic Messages | source.data | 裸 Base64 + media_type | Claude 视觉理解输出文本 |
| Gemini Generate Content | inlineData.data | 裸 Base64 + mimeType | 生图结果：parts[].inlineData.data |
接入步骤
- 先读取模型列表
调用
GET /v1/models，从返回结果中复制完整模型 ID。 - 按模型选择协议
GPT 使用 OpenAI 接口，Claude 可使用 Anthropic Messages，Gemini 使用 Generate Content。
- 按对应格式传入媒体
Responses 使用 Data URL；Anthropic 与 Gemini 使用裸 Base64 并单独填写 MIME 类型；Images Edits 使用 multipart 文件。
协议参考
本页示例按 YunQi AI 的模型 ID、接口路径和参数格式编写；以下链接提供对应协议的字段说明。