大模型 API 参考

1
[
2
  {
3
    "role": "user",
4
    "content": [
5
      {
6
        "type": "text",
7
        "text": "描述这张图片。"
8
      },
9
      {
10
        "type": "image_url",
11
        "image_url": {
12
          "url": "https://www.example.com/example.jpg",
13
          "detail": "auto"
14
        }
15
      }
16
    ]
17
  }
18
]

1
{
2
  "model": "gpt-6-astra",
3
  "messages": [
4
    {
5
      "role": "system",
6
      "content": "用中文简短回答。"
7
    },
8
    {
9
      "role": "user",
10
      "content": "什么是 HTTP？"
11
    },
12
    {
13
      "role": "assistant",
14
      "content": "HTTP 是客户端和服务器交换请求与响应的协议。"
15
    },
16
    {
17
      "role": "user",
18
      "content": "HTTPS 多了什么？"
19
    }
20
  ]
21
}

1
{
2
  "model": "gpt-6-astra",
3
  "messages": [
4
    {
5
      "role": "user",
6
      "content": "杭州现在的天气如何？"
7
    }
8
  ],
9
  "tools": [
10
    {
11
      "type": "function",
12
      "function": {
13
        "name": "get_weather",
14
        "description": "查询指定城市的当前天气。",
15
        "parameters": {
16
          "type": "object",
17
          "properties": {
18
            "city": {
19
              "type": "string"
20
            }
21
          },
22
          "required": [
23
            "city"
24
          ],
25
          "additionalProperties": false
26
        },
27
        "strict": true
28
      }
29
    }
30
  ],
31
  "tool_choice": "auto"
32
}

1
[
2
  {
3
    "role": "assistant",
4
    "content": null,
5
    "tool_calls": [
6
      {
7
        "id": "call_weather_1",
8
        "type": "function",
9
        "function": {
10
          "name": "get_weather",
11
          "arguments": "{\"city\":\"杭州\"}"
12
        }
13
      }
14
    ]
15
  },
16
  {
17
    "role": "tool",
18
    "tool_call_id": "call_weather_1",
19
    "content": "{\"temperature_c\":22,\"condition\":\"晴\"}"
20
  }
21
]

1
{
2
  "type": "json_schema",
3
  "json_schema": {
4
    "name": "city_result",
5
    "strict": true,
6
    "schema": {
7
      "type": "object",
8
      "properties": {
9
        "city": {
10
          "type": "string"
11
        }
12
      },
13
      "required": [
14
        "city"
15
      ],
16
      "additionalProperties": false
17
    }
18
  }
19
}

1
[
2
  {
3
    "role": "user",
4
    "content": [
5
      {
6
        "type": "input_text",
7
        "text": "描述这张图片。"
8
      },
9
      {
10
        "type": "input_image",
11
        "image_url": "https://www.example.com/example.jpg",
12
        "detail": "auto"
13
      }
14
    ]
15
  }
16
]

1
{
2
  "model": "gpt-6-astra",
3
  "previous_response_id": "resp_weather_example",
4
  "input": [
5
    {
6
      "type": "function_call_output",
7
      "call_id": "call_weather_1",
8
      "output": "{\"temperature_c\":22,\"condition\":\"晴\"}"
9
    }
10
  ]
11
}

1
{
2
  "model": "gpt-6-astra",
3
  "previous_response_id": "resp_example",
4
  "instructions": "继续用中文简短回答。",
5
  "input": "HTTPS 多了什么？"
6
}

1
{
2
  "model": "gpt-6-astra",
3
  "input": "杭州现在的天气如何？",
4
  "tools": [
5
    {
6
      "type": "function",
7
      "name": "get_weather",
8
      "description": "查询指定城市的当前天气。",
9
      "parameters": {
10
        "type": "object",
11
        "properties": {
12
          "city": {
13
            "type": "string"
14
          }
15
        },
16
        "required": [
17
          "city"
18
        ],
19
        "additionalProperties": false
20
      },
21
      "strict": true
22
    }
23
  ],
24
  "tool_choice": "auto"
25
}

1
{
2
  "text": {
3
    "format": {
4
      "type": "json_schema",
5
      "name": "city_result",
6
      "strict": true,
7
      "schema": {
8
        "type": "object",
9
        "properties": {
10
          "city": {
11
            "type": "string"
12
          }
13
        },
14
        "required": [
15
          "city"
16
        ],
17
        "additionalProperties": false
18
      }
19
    }
20
  }
21
}

1
[
2
  {
3
    "role": "user",
4
    "content": "你好，Claude。"
5
  },
6
  {
7
    "role": "assistant",
8
    "content": [
9
      {
10
        "type": "text",
11
        "text": "你好。"
12
      }
13
    ]
14
  }
15
]

1
{
2
  "role": "user",
3
  "content": [
4
    {
5
      "type": "image",
6
      "source": {
7
        "type": "url",
8
        "url": "https://www.example.com/example.jpg"
9
      }
10
    },
11
    {
12
      "type": "text",
13
      "text": "描述这张图片。"
14
    }
15
  ]
16
}

1
{
2
  "type": "document",
3
  "source": {
4
    "type": "text",
5
    "media_type": "text/plain",
6
    "data": "HTTP 采用请求与响应的交互方式。"
7
  },
8
  "title": "HTTP 摘要",
9
  "citations": {
10
    "enabled": true
11
  }
12
}

1
{
2
  "model": "claude-opus-5-5",
3
  "max_tokens": 1024,
4
  "system": "用中文简短回答。",
5
  "messages": [
6
    {
7
      "role": "user",
8
      "content": "什么是 HTTP？"
9
    },
10
    {
11
      "role": "assistant",
12
      "content": [
13
        {
14
          "type": "text",
15
          "text": "HTTP 是请求与响应协议。"
16
        }
17
      ]
18
    },
19
    {
20
      "role": "user",
21
      "content": "HTTPS 多了什么？"
22
    }
23
  ]
24
}

1
{
2
  "model": "claude-opus-5-5",
3
  "max_tokens": 1024,
4
  "messages": [
5
    {
6
      "role": "user",
7
      "content": "杭州现在的天气如何？"
8
    }
9
  ],
10
  "tools": [
11
    {
12
      "name": "get_weather",
13
      "description": "查询指定城市的当前天气。",
14
      "input_schema": {
15
        "type": "object",
16
        "properties": {
17
          "city": {
18
            "type": "string"
19
          }
20
        },
21
        "required": [
22
          "city"
23
        ],
24
        "additionalProperties": false
25
      }
26
    }
27
  ],
28
  "tool_choice": {
29
    "type": "auto"
30
  }
31
}

1
[
2
  {
3
    "role": "assistant",
4
    "content": [
5
      {
6
        "type": "tool_use",
7
        "id": "toolu_weather_1",
8
        "name": "get_weather",
9
        "input": {
10
          "city": "杭州"
11
        }
12
      }
13
    ]
14
  },
15
  {
16
    "role": "user",
17
    "content": [
18
      {
19
        "type": "tool_result",
20
        "tool_use_id": "toolu_weather_1",
21
        "content": "{\"temperature_c\":22,\"condition\":\"晴\"}"
22
      }
23
    ]
24
  }
25
]

1
{
2
  "output_config": {
3
    "format": {
4
      "type": "json_schema",
5
      "schema": {
6
        "type": "object",
7
        "properties": {
8
          "city": {
9
            "type": "string"
10
          }
11
        },
12
        "required": [
13
          "city"
14
        ],
15
        "additionalProperties": false
16
      }
17
    }
18
  }
19
}