Responses格式

OpenAI Responses API,用于创建模型响应。 支持多轮对话、工具调用、推理等功能。

POST/v1/responses

Responses格式

OpenAI Responses API,用于创建模型响应。 支持多轮对话、工具调用、推理等功能。

鉴权: 使用 Bearer Token 认证。 格式: `Authorization: Bearer sk-xxxxxx`

请求体

必填

Content-Type: application/json

字段类型必填说明
modelstring是
inputstring | array<object>输入内容,可以是字符串或消息数组
[]object
instructionsstring
max_output_tokensinteger
temperaturenumber
top_pnumber
streamboolean
toolsarray<object>
[]object
tool_choicestring | object
reasoningobject
effortstring可选值: low, medium, high
summarystring
previous_response_idstring
truncationstring可选值: auto, disabled

示例代码

curl -X POST "https://api.nodeprice.com/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
  "model": "string",
  "input": "string",
  "instructions": "string",
  "max_output_tokens": 0,
  "temperature": 0,
  "top_p": 0,
  "stream": false,
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "reasoning": {
    "effort": "low",
    "summary": "string"
  },
  "previous_response_id": "string",
  "truncation": "auto"
}'
const url = "https://api.nodeprice.com/v1/responses";
const body = {
  "model": "string",
  "input": "string",
  "instructions": "string",
  "max_output_tokens": 0,
  "temperature": 0,
  "top_p": 0,
  "stream": false,
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "reasoning": {
    "effort": "low",
    "summary": "string"
  },
  "previous_response_id": "string",
  "truncation": "auto"
};

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
  },
  body: JSON.stringify(body)
});

console.log(await response.text());
package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	url := "https://api.nodeprice.com/v1/responses"
	body := strings.NewReader(`{
  "model": "string",
  "input": "string",
  "instructions": "string",
  "max_output_tokens": 0,
  "temperature": 0,
  "top_p": 0,
  "stream": false,
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "reasoning": {
    "effort": "low",
    "summary": "string"
  },
  "previous_response_id": "string",
  "truncation": "auto"
}`)
	req, err := http.NewRequest("POST", url, body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer <token>")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(data))
}
import requests

url = "https://api.nodeprice.com/v1/responses"

body = """{
  "model": "string",
  "input": "string",
  "instructions": "string",
  "max_output_tokens": 0,
  "temperature": 0,
  "top_p": 0,
  "stream": false,
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "reasoning": {
    "effort": "low",
    "summary": "string"
  },
  "previous_response_id": "string",
  "truncation": "auto"
}"""

response = requests.request("POST", url, data=body, headers={
  "Content-Type": "application/json",
  "Authorization": "Bearer <token>"
})

print(response.text)
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n"
    + "  \"model\": \"string\",\n"
    + "  \"input\": \"string\",\n"
    + "  \"instructions\": \"string\",\n"
    + "  \"max_output_tokens\": 0,\n"
    + "  \"temperature\": 0,\n"
    + "  \"top_p\": 0,\n"
    + "  \"stream\": false,\n"
    + "  \"tools\": [\n"
    + "    {}\n"
    + "  ],\n"
    + "  \"tool_choice\": \"string\",\n"
    + "  \"reasoning\": {\n"
    + "    \"effort\": \"low\",\n"
    + "    \"summary\": \"string\"\n"
    + "  },\n"
    + "  \"previous_response_id\": \"string\",\n"
    + "  \"truncation\": \"auto\"\n"
    + "}");
Request request = new Request.Builder()
    .url("https://api.nodeprice.com/v1/responses")
    .method("POST", body)
    .addHeader("Content-Type", "application/json")
    .addHeader("Authorization", "Bearer <token>")
    .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());
#include <stdio.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl == NULL) {
        return 1;
    }

    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, "Content-Type: application/json");
    headers = curl_slist_append(headers, "Authorization: Bearer <token>");

    curl_easy_setopt(curl, CURLOPT_URL, "https://api.nodeprice.com/v1/responses");
    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\n"
        + "  \"model\": \"string\",\n"
        + "  \"input\": \"string\",\n"
        + "  \"instructions\": \"string\",\n"
        + "  \"max_output_tokens\": 0,\n"
        + "  \"temperature\": 0,\n"
        + "  \"top_p\": 0,\n"
        + "  \"stream\": false,\n"
        + "  \"tools\": [\n"
        + "    {}\n"
        + "  ],\n"
        + "  \"tool_choice\": \"string\",\n"
        + "  \"reasoning\": {\n"
        + "    \"effort\": \"low\",\n"
        + "    \"summary\": \"string\"\n"
        + "  },\n"
        + "  \"previous_response_id\": \"string\",\n"
        + "  \"truncation\": \"auto\"\n"
        + "}");
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

    CURLcode code = curl_easy_perform(curl);
    if (code != CURLE_OK) {
        fprintf(stderr, "%s\n", curl_easy_strerror(code));
    }

    curl_slist_free_all(headers);
    curl_easy_cleanup(curl);
    return 0;
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var request = new HttpRequestMessage(HttpMethod.Post, "https://api.nodeprice.com/v1/responses");
        request.Headers.Add("Authorization", "Bearer <token>");
        request.Content = new StringContent("{\n"
            + "  \"model\": \"string\",\n"
            + "  \"input\": \"string\",\n"
            + "  \"instructions\": \"string\",\n"
            + "  \"max_output_tokens\": 0,\n"
            + "  \"temperature\": 0,\n"
            + "  \"top_p\": 0,\n"
            + "  \"stream\": false,\n"
            + "  \"tools\": [\n"
            + "    {}\n"
            + "  ],\n"
            + "  \"tool_choice\": \"string\",\n"
            + "  \"reasoning\": {\n"
            + "    \"effort\": \"low\",\n"
            + "    \"summary\": \"string\"\n"
            + "  },\n"
            + "  \"previous_response_id\": \"string\",\n"
            + "  \"truncation\": \"auto\"\n"
            + "}", Encoding.UTF8, "application/json");

        var response = await client.SendAsync(request);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

响应

200 成功创建响应

Content-Type: application/json

字段类型必填说明
idstring
objectstring示例: "response"
created_atinteger
statusstring可选值: completed, failed, in_progress, incomplete
modelstring
outputarray<object>
[]object
typestring
idstring
statusstring
rolestring
contentarray<object>
[]object
typestring
textstring
usageobject
prompt_tokensinteger提示词 Token 数
completion_tokensinteger补全 Token 数
total_tokensinteger总 Token 数
prompt_tokens_detailsobject
cached_tokensinteger
text_tokensinteger
audio_tokensinteger
image_tokensinteger
completion_tokens_detailsobject
text_tokensinteger
audio_tokensinteger
reasoning_tokensinteger