Chat（结构化输出）

正式环境

https://api.302.ai

POST

/v1/chat/completions

官方指南
官方API文档

此范例是为了展示如何使用gpt-4o模型进行结构化输出。
聊天模型接受一系列消息作为输入，然后返回模型生成的消息作为输出。尽管聊天格式是为了让多轮对话变得简单而设计的，但它对于没有任何对话的单轮任务也同样有用。

价格请查看：https://302.ai/price

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-4o-2024-08-06",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful math tutor. Guide the user through the solution step by step."
      },
      {
        "role": "user",
        "content": "9.11和9.8谁大"
      }
    ],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "math_reasoning",
        "schema": {
          "type": "object",
          "properties": {
            "steps": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "explanation": { "type": "string" },
                  "output": { "type": "string" }
                },
                "required": ["explanation", "output"],
                "additionalProperties": false
              }
            },
            "final_answer": { "type": "string" }
          },
          "required": ["steps", "final_answer"],
          "additionalProperties": false
        },
        "strict": true
      }
    }
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-4o-2024-08-06",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful math tutor. Guide the user through the solution step by step."
      },
      {
        "role": "user",
        "content": "9.11和9.8谁大"
      }
    ],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "math_reasoning",
        "schema": {
          "type": "object",
          "properties": {
            "steps": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "explanation": { "type": "string" },
                  "output": { "type": "string" }
                },
                "required": ["explanation", "output"],
                "additionalProperties": false
              }
            },
            "final_answer": { "type": "string" }
          },
          "required": ["steps", "final_answer"],
          "additionalProperties": false
        },
        "strict": true
      }
    }
  }'

返回响应

🟢200OK

application/json

Body

示例

{
    "id": "chatcmpl-Cx4v7ltd4mYWI2G88ELBEwhCc2kKU",
    "model": "gpt-4o-2024-08-06",
    "object": "chat.completion",
    "choices": [
        {
            "delta": {
                "role": "assistant",
                "content": "{\"steps\":[{\"explanation\":\"首先，我们比较两个小数：9.11 和 9.8。\",\"output\":\"两个小数分别为 9.11 和 9.8。\"},{\"explanation\":\"从整数部分来看，两个数字的整数部分相同，都是 9，因此我们需要比较它们的小数部分。\",\"output\":\"小数部分是 0.11 和 0.8。\"},{\"explanation\":\"为了比较小数部分，可以将它们转化为同样位数的小数，即将 0.8 写成 0.80，然后比较 0.11 和 0.80。\",\"output\":\"0.11 和 0.80\"},{\"explanation\":\"比较 0.11 和 0.80：0.11 比 0.80 小，因为 0.80 的十分位是 8，而 0.11 的十分位是 1。\",\"output\":\"0.11 < 0.80\"},{\"explanation\":\"将比较结果应用到原始数字中：因为 9.11 的小数部分比 9.8 的小数部分小，所以 9.11 小于 9.8。\",\"output\":\"9.11 < 9.8\"}],\"final_answer\":\"9.8\"}"
            },
            "message": {
                "role": "assistant",
                "content": "{\"steps\":[{\"explanation\":\"首先，我们比较两个小数：9.11 和 9.8。\",\"output\":\"两个小数分别为 9.11 和 9.8。\"},{\"explanation\":\"从整数部分来看，两个数字的整数部分相同，都是 9，因此我们需要比较它们的小数部分。\",\"output\":\"小数部分是 0.11 和 0.8。\"},{\"explanation\":\"为了比较小数部分，可以将它们转化为同样位数的小数，即将 0.8 写成 0.80，然后比较 0.11 和 0.80。\",\"output\":\"0.11 和 0.80\"},{\"explanation\":\"比较 0.11 和 0.80：0.11 比 0.80 小，因为 0.80 的十分位是 8，而 0.11 的十分位是 1。\",\"output\":\"0.11 < 0.80\"},{\"explanation\":\"将比较结果应用到原始数字中：因为 9.11 的小数部分比 9.8 的小数部分小，所以 9.11 小于 9.8。\",\"output\":\"9.11 < 9.8\"}],\"final_answer\":\"9.8\"}"
            },
            "index": 0,
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 96,
        "completion_tokens": 269,
        "total_tokens": 365,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "audio_tokens": 0
        },
        "completion_tokens_details": {
            "accepted_prediction_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 0,
            "rejected_prediction_tokens": 0
        }
    },
    "created": 1768196301,
    "system_fingerprint": "fp_4a331a0222"
}

修改于 2026-01-26 06:36:42

Chat（分析图片）

Chat（函数调用）