文本系列GPTGPT-5.2

GPT-5.2 - 完整参数文档

使用 OpenAI SDK 格式调用 GPT-5.2 模型

同步处理模式，实时返回对话内容
纯文本对话：单轮或多轮上下文对话
系统提示词：自定义 AI 的角色和行为
多模态输入：支持文本 + 图像混合输入 <Note> **BaseURL 说明**：默认 BaseURL 为 `https://api.starmagic.ai`，对文本模型支持更好，支持长连接；`https://api.starmagic.ai` 是多模态主力地址，对文本模型作为备用地址使用。

</Note>

授权

Authorizationstringheader必填

##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

请求体

application/json

modelenum<gpt-5.2>必填

对话模型名称

"gpt-5.2"

messagesobject[]必填

对话消息列表，支持多轮对话和多模态输入（文本、图片）

[
  {
    "role": "user",
    "content": [
      null
    ]
  }
]

streamboolean

是否以流式方式返回响应 - `true`: 流式返回，逐块实时返回内容 - `false`: 等待完整响应后一次性返回

false

temperaturenumber

采样温度，控制输出的随机性 **说明**: - 较低值(如 0.2): 更确定、更聚焦的输出 - 较高值(如 1.5): 更随机、更有创意的输出

0.7

top_pnumber

核采样(Nucleus Sampling)参数 **说明**: - 控制从累积概率前多少的token中采样 - 例如 0.9 表示从累积概率达到90%的token中选择 - 默认值: 1.0（考虑所有token） **建议**: 不要同时调整 temperature 和 top_p

0.9

top_kinteger

Top-K 采样参数 **说明**: - 例如 10 表示限制每次采样时只考虑概率最高的 10 个 token - 较小的值会使输出更加聚焦 - 默认不限制

响应

application/json

成功

响应体

idstring

对话完成的唯一标识符

"chatcmpl-20251010015944503180122WJNB8Eid"

modelstring

实际使用的模型名称

"gpt-5.2"

objectenum<chat.completion>

响应类型

"chat.completion"

createdinteger

创建时间戳

1760032810

choicesobject[]

对话生成的选择列表

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是 GPT-5.2，拥有更强的推理和理解能力。我在处理复杂问题、多步骤推理和代码生成方面表现出色。\\n\\n主要特点包括：\\n- 更强的逻辑推理能力\\n- 更好的上下文理解\\n- 更准确的代码生成"
    },
    "finish_reason": "stop"
  }
]

usageobject

Token 使用统计信息

{
  "prompt_tokens": 13,
  "completion_tokens": 1891,
  "total_tokens": 1904,
  "prompt_tokens_details": {
    "cached_tokens": 0,
    "text_tokens": 13,
    "audio_tokens": 0,
    "image_tokens": 0
  },
  "completion_tokens_details": {
    "text_tokens": 0,
    "audio_tokens": 0,
    "reasoning_tokens": 1480
  },
  "input_tokens": 0,
  "output_tokens": 0,
  "input_tokens_details": null
}

POST/v1/chat/completions

curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.2",
  "messages": [
    {
      "role": "user",
      "content": "请介绍一下你自己"
    }
  ]
}'

响应: 成功

{
  "id": "chatcmpl-20251010015944503180122WJNB8Eid",
  "model": "gpt-5.2",
  "object": "chat.completion",
  "created": 1760032810,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 1891,
    "total_tokens": 1904,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 13,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 1480
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null
  }
}

GPT-5.2 - 完整参数文档

使用 OpenAI SDK 格式调用 GPT-5.2 模型

同步处理模式，实时返回对话内容

纯文本对话：单轮或多轮上下文对话

系统提示词：自定义 AI 的角色和行为

多模态输入：支持文本 + 图像混合输入 <Note> **BaseURL 说明**：默认 BaseURL 为 `https://api.starmagic.ai`，对文本模型支持更好，支持长连接；`https://api.starmagic.ai` 是多模态主力地址，对文本模型作为备用地址使用。

[ { "index": 0, "message": { "role": "assistant", "content": "你好！我是 GPT-5.2，拥有更强的推理和理解能力。我在处理复杂问题、多步骤推理和代码生成方面表现出色。\\n\\n主要特点包括：\\n- 更强的逻辑推理能力\\n- 更好的上下文理解\\n- 更准确的代码生成" }, "finish_reason": "stop" } ]

{ "prompt_tokens": 13, "completion_tokens": 1891, "total_tokens": 1904, "prompt_tokens_details": { "cached_tokens": 0, "text_tokens": 13, "audio_tokens": 0, "image_tokens": 0 }, "completion_tokens_details": { "text_tokens": 0, "audio_tokens": 0, "reasoning_tokens": 1480 }, "input_tokens": 0, "output_tokens": 0, "input_tokens_details": null }

curl --request POST \ --url https://api.starmagic.ai/v1/chat/completions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "gpt-5.2", "messages": [ { "role": "user", "content": "请介绍一下你自己" } ] }'

{ "id": "chatcmpl-20251010015944503180122WJNB8Eid", "model": "gpt-5.2", "object": "chat.completion", "created": 1760032810, "choices": [ { "index": 0, "message": { "role": null, "content": null }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 13, "completion_tokens": 1891, "total_tokens": 1904, "prompt_tokens_details": { "cached_tokens": 0, "text_tokens": 13, "audio_tokens": 0, "image_tokens": 0 }, "completion_tokens_details": { "text_tokens": 0, "audio_tokens": 0, "reasoning_tokens": 1480 }, "input_tokens": 0, "output_tokens": 0, "input_tokens_details": null } }