请求方式: POST

请求地址: /v1/responses

适用模型: deepseek-v4-flash

请求参数:

• model: 必选, 模型名, 对应接口 /v1/models 中的 id, 例如 "model": "deepseek-v4-flash"

• input: 必选, 推理请求的输入内容, 支持两种格式:

  1. 字符串格式: 直接传入一段文本, 例如 "input": "用一句话解释什么是API。"
  2. 数组格式: 传入 role + content 的消息结构, 支持多轮对话, 例如:

  "input": [
      { "role": "user", "content": "什么是API？" },
      { "role": "assistant", "content": "API是应用程序接口的缩写。" },
      { "role": "user", "content": "举个例子？" }
  ]

• instructions: 可选, 字符串格式. 用于向模型传递系统级指令, 引导模型的输出风格、语气或限制范围. 例如 "instructions": "请用通俗易懂的语言回答"

• stream: 可选, 是否为流式推理, 默认值为 false, [true: 流式推理, false: 文本推理]

• temperature: 可选, 温度参数控制模型生成的文本的创造性. 较低的温度会导致更可预测的文本, 较高的温度会导致更随机的文本. 默认值为 1.0, 可选范围 [0.0, 2.0]

• max_output_tokens: 可选, 允许推理生成的最大 token 个数. 正整数.

• top_p: 可选, 控制模型生成过程中考虑的词汇范围, 基于累计概率选择候选词. 默认值为 1.0, 可选范围 (0.0, 1.0]

• frequency_penalty: 可选, 频率惩罚, 介于 -2.0 和 2.0 之间. 正值将通过惩罚常用词, 增加模型谈论新主题的可能性; 负值则相反. 默认值为 0.0

• presence_penalty: 可选, 存在惩罚, 介于 -2.0 和 2.0 之间. 正值将通过惩罚已经使用的词, 增加模型谈论新主题的可能性; 负值则相反. 默认值为 0.0

• stop: 可选, 字符串数组. 生成文本遇到数组中任一字符串时停止推理, 输出结果默认不包含停止字符串.

  "stop": ["。", "END"]

• seed: 可选, 用于指定推理过程的随机种子, 相同的 seed 值可以确保推理结果的可重现性. 整数类型.

• user: 可选, 字符串类型. 终端用户标识符, 用于上游服务进行使用监控或滥用检测.

• response_format: 可选, 指定模型输出的格式, 常用于启用 JSON 模式. 例如:

  "response_format": { "type": "json_object" }

• previous_response_id: 可选, 字符串类型. 上一轮响应的 id, 用于在多轮对话中引用上一次响应的上下文.

请求和响应示例 - 非流式

curl -X POST "https://uni-api.cstcloud.cn/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {Token}" \
  -d '{
    "model": "deepseek-v4-flash",
    "input": "用一句话解释什么是API。"
  }'

返回结果

{
    "id": "resp_207d2f76ceb447b2b612cef2228dd708",
    "object": "response",
    "created_at": 1787538178,
    "model": "deepseek-v4-flash",
    "output": [
        {
            "id": "msg_305a9d7624a7497180baa79f1ebc46b4",
            "content": [
                {
                    "annotations": [],
                    "text": "API是应用程序之间约定的\"接口协议\"，让不同软件像插头接插座一样，无需知道内部细节就能安全地请求数据或功能。",
                    "type": "output_text",
                    "logprobs": null
                }
            ],
            "role": "assistant",
            "status": "completed",
            "type": "message"
        }
    ],
    "status": "completed",
    "usage": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 0,
        "reasoning_tokens": 0
    },
    "tool_choice": "auto",
    "tools": [],
    "error": null
}

请求和响应示例 - 流式

curl -N -X POST "https://uni-api.cstcloud.cn/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {Token}" \
  -d '{
    "model": "deepseek-v4-flash",
    "input": "用一句话解释什么是API。",
    "stream": true
  }'

返回结果 (server-send-event)

event: response.created
data: {"response":{"id":"resp_0e2555e3ee6840e68a20bb574449b0f8","created_at":1787542400.0,"model":"deepseek-v4-flash","object":"response","output":[],"status":"in_progress","usage":null,...},"sequence_number":0,"type":"response.created"}

event: response.in_progress
data: {"response":{"id":"resp_0e2555e3ee6840e68a20bb574449b0f8","created_at":1787542400.0,"model":"deepseek-v4-flash","object":"response","output":[],"status":"in_progress","usage":null,...},"sequence_number":1,"type":"response.in_progress"}

event: response.completed
data: {"response":{"id":"resp_0e2555e3ee6840e68a20bb574449b0f8","created_at":1787542400.0,"model":"deepseek-v4-flash","object":"response","output":[{"id":"msg_300f19c39b1b4d329311810214921ebf","content":[{"annotations":[],"text":"API（应用程序接口）是让不同软件程序之间无需了解对方内部实现，就能按照预先定义的规则相互请求数据和功能的\"标准化信使\"。","type":"output_text","logprobs":null}],"role":"assistant","status":"completed","type":"message"}],"status":"completed","usage":{"input_tokens":0,"output_tokens":0,"total_tokens":0,"input_tokens_details":{"cached_tokens":0},"output_tokens_details":{"reasoning_tokens":0}}},"sequence_number":2,"type":"response.completed"}

流式事件类型说明:

事件	说明
response.created	响应对象已创建, 此时 output 为空数组, status 为 in_progress
response.in_progress	推理进行中
response.completed	推理完成, 包含完整的 output 数组和 usage 字段, status 为 completed