Skip to main content
POST
  • 完全兼容 OpenAI Responses API 格式
  • 支持文本和图像的多模态输入
  • 支持工具扩展:网络搜索、文件搜索、函数调用、远程 MCP

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
必填
模型名称支持的模型包括:
  • gpt-5 - GPT-5 基础模型
  • gpt-5-pro - GPT-5 专业增强版(仅支持此接口)
  • gpt-5-codex - GPT-5 Codex 代码模型(仅支持此接口)
  • gpt-5.1-codex - GPT-5.1 Codex 代码模型(仅支持此接口)
  • gpt-5.1-codex-mini - GPT-5.1 Codex Mini(仅支持此接口)
  • gpt-5.2-codex - GPT-5.2 Codex 代码模型(仅支持此接口)
  • gpt-5.3-codex - GPT-5.3 Codex 代码模型(仅支持此接口)
  • 以及所有支持 /v1/chat/completions 的模型
gpt-5-pro 和所有 Codex 系列模型仅支持此接口(/v1/responses),不支持 /v1/chat/completions
string or array
必填
输入内容,支持字符串或消息数组字符串形式为简单文本输入,数组形式支持多轮对话和多模态:
array
工具列表,可选配置支持的工具类型:
  • web_search - 网络搜索
  • file_search - 文件搜索
  • function - 函数调用
  • remote_mcp - 远程 MCP 服务
number
控制输出随机性,范围 0-2默认值:1.0
integer
生成的最大 token 数量
boolean
是否使用流式输出默认值:false

Response

string
响应的唯一标识符
string
对象类型,固定为 response
integer
创建时间戳
string
实际使用的模型名称(如 gpt-5-2025-08-07
string
响应状态可能的值:
  • completed - 已完成
  • in_progress - 处理中
  • failed - 失败
  • cancelled - 已取消
array
输出内容数组
object
token 使用统计
object
推理配置信息(思考模型专用)
number
实际使用的采样温度
number
实际使用的核采样参数
string
工具选择策略
array
使用的工具列表
boolean
是否允许并行工具调用
boolean
是否存储对话历史
string
服务等级
string
截断策略
object
文本格式配置
boolean
是否为后台任务
object
错误信息(如果有)
object
元数据信息

使用示例

图片分析

视频分析

使用网络搜索工具

使用函数调用

内容类型说明

input_text

文本输入类型 属性:
  • type: 固定为 "input_text"
  • text: 文本内容(字符串)

input_image

图像输入类型 属性:
  • type: 固定为 "input_image"
  • image_url: 图像 URL 或 Base64 编码的数据 URI
支持的图像格式:
  • JPEG
  • PNG
  • GIF
  • WebP
图像大小限制:
  • 最大文件大小:20MB
  • 推荐分辨率:不超过 2048x2048 像素

input_video

视频输入类型(部分模型支持) 属性:
  • type: 固定为 "input_video"
  • video_url: 视频 URL
支持的视频格式:
  • MP4
  • MOV
  • AVI
  • WebM
视频大小限制:
  • 最大文件大小:200MB
  • 最大时长:10 分钟
  • 推荐分辨率:1080p

工具使用详解

使用网络搜索工具可以让模型访问实时互联网信息。 配置示例:
适用场景:
  • 查询最新新闻和时事
  • 获取实时数据(股票、天气、汇率等)
  • 搜索最新的技术文档和资料
  • 验证事实信息
文件搜索工具允许模型在已上传的文档中搜索相关信息。 配置示例:
适用场景:
  • 分析企业内部文档
  • 搜索技术规范和手册
  • 查询合同和法律文件
  • 知识库问答系统

函数调用 (Function Calling)

定义自定义函数,让模型能够调用外部 API 或执行特定操作。 完整配置示例:
参数说明:
  • name: 函数名称(必需)
  • description: 函数功能描述(必需)
  • parameters: 参数定义,使用 JSON Schema 格式
    • type: 参数类型
    • properties: 参数属性定义
    • required: 必需参数列表
适用场景:
  • 调用第三方 API
  • 执行数据库查询
  • 触发业务流程
  • 与内部系统集成

远程 MCP (Remote MCP)

连接到远程模型上下文协议(MCP)服务,扩展模型能力。 配置示例:
参数说明:
  • url: MCP 服务器地址(必需)
  • auth_token: 认证令牌(可选)
  • timeout: 超时时间(秒),默认 30 秒
适用场景:
  • 连接企业级 AI 服务
  • 使用专业领域模型
  • 访问受保护的数据源
  • 分布式 AI 系统集成

工具响应格式

当模型使用工具时,响应格式会包含工具调用信息:
工具调用流程:
  1. 模型接收用户输入
  2. 分析是否需要使用工具
  3. 如需要,返回工具调用请求
  4. 客户端执行工具调用
  5. 将工具结果返回给模型
  6. 模型生成最终响应

注意事项

  1. 图像 URL 要求
    • 必须是公开可访问的 URL
    • 或使用 Base64 编码的 Data URI 格式
  2. Token 计费
    • 图像会根据其分辨率消耗相应的 tokens
    • 高分辨率图像会自动调整大小以优化成本
    • 工具调用也会消耗额外的 tokens
  3. 内容顺序
    • content 数组中的元素顺序会影响模型理解
    • 建议先放置文本指令,再放置图像/视频
  4. 多模态组合
    • 可以在一个请求中混合多个文本和图像
    • 支持多轮对话,保持上下文连贯性
  5. 工具使用限制
    • 同时使用多个工具时,模型会智能选择最合适的工具
    • 函数调用需要明确的函数定义和参数说明
    • 网络搜索结果可能受地域和时间限制
  6. API 兼容性
    • 完全兼容 OpenAI Responses API 格式
    • 可无缝迁移现有 OpenAI 代码
    • 支持所有 OpenAI 工具扩展功能