开发者文档 场景示例
场景示例
从完整的小任务开始，把接口接进自己的应用。
01 · 对话体验
多轮聊天
保存消息历史，让下一轮接着上一轮继续。
查看完整示例 →02 · 数据处理结构化输出
获取 JSON，并校验业务需要的字段与类型。
查看完整示例 →03 · 应用集成工具调用
声明函数、校验参数、执行并回传结果。
查看完整示例 →04 · 多模态输入图片理解
发送图片与问题，读取模型对画面的描述。
查看完整示例 →如何选择
| 场景 | 模型前提 | 你会得到 |
|---|---|---|
| 多轮聊天 | 文本对话 | 消息历史与第二轮回答 |
| 结构化输出 | 上游支持 json_object 模式 | JSON 解析与字段校验 |
| 工具调用 | 上游支持 tools | 有边界的函数调用循环 |
| 图片理解 | 上游支持图片输入 | 图片内容块与文本回答 |
四篇都调用 POST /v1/chat/completions。这个入口不做协议转换，只能用控制台模型详情中列有 OpenAI Chat Completions 的模型，其他模型返回 400。网关不检查 response_format、tools 和图片内容块，原样交给上游，能否生效由所选模型决定。
每篇提供完整的 Python 标准库示例，可从页头复制 Markdown 或下载 .py 文件。密钥在控制台限定了模型范围时，范围外的模型返回 403 model_not_allowed；用这把密钥请求 /v1/models 可以看到它能调用的模型。
流式与其他接口
实际可调用的模型、授权与价格以控制台为准。
页面字体：MiSans（小米，依《MiSans 字体知识产权许可协议》使用）；Google Sans Flex（SIL Open Font License 1.1）。
页面字体：MiSans（小米，依《MiSans 字体知识产权许可协议》使用）；Google Sans Flex（SIL Open Font License 1.1）。