gpt-4o (文本转文本 (Chat))

来源: https://docs.surgeai.one/docs/allapi/OpenAI/gpt-4o/official-format/text-to-text-chat

使用对话补全 API 生成文本响应

OpenAI 文本转文本 API 的官方格式(chat)。

身份验证

在 https://surgeai.one 注册 SurgeAI 账户

进入控制台的 API Keys 部分

生成新的 API 密钥 (sk-xxxxx)

复制并安全存储您的 API 密钥

端点

POST /v1/chat/completions

cURL 示例

成功响应 (200)

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699896916,
  "model": "gpt-5-chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The image shows a wooden boardwalk path extending through a lush green grassland."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1250,
    "completion_tokens": 89,
    "total_tokens": 1339
  }
}

错误响应

401 - 无效签名 / API 密钥缺失或无效

403 - 余额不足 / 您的 API 密钥没有权限

429 - 请求过多 / 您已超出速率限制

500 - 服务器内部错误

503 - 内容策略违规

{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}

核心参数

参数	类型	必填	默认值	范围	描述
`model`	string	是	-	-	用于生成响应的模型 ID,如 `gpt-4o` 或 `o3`。OpenAI 提供多种具有不同能力、性能特点和价格档位的模型。
`messages`	array	是	-	-	包含当前对话的消息列表。根据您使用的模型,支持不同的消息类型(模态),如文本、图像和音频。
`messages.role`	string	是	-	`developer`、`user`、`system`	消息作者的角色。
`messages.name`	string	否	-	-	参与者的可选名称。为模型提供信息以区分相同角色的不同参与者。
`messages.content`	string/array	是	-	-	开发者消息的内容。
`messages.content.type`	string	是	-	`text`、`image_url`	内容部分的类型
`messages.content.text`	string	否	-	-	文本内容
`messages.content.image_url`	object	否	-	-	图像 URL 内容
`messages.content.image_url.url`	string	否	-	-	图像的 URL

高级参数

参数	类型	必填	默认值	范围	描述
`max_completion_tokens`	integer/null	否	-	-	补全可生成的 token 数量上限,包括可见的输出 token 和推理 token。
`stream`	boolean	否	`false`	`true`、`false`	是否以增量方式流式返回响应。默认为 false。

gpt-4o (文本转文本 (Chat))

身份验证#

端点#

cURL 示例#

成功响应 (200)#

错误响应#

核心参数#