Skip to content
Request
Response

响应(Responses)

异步任务结果查询接口,用于获取异步推理任务的结果查询,也支持直接同步调用生成内容。

接口地址

POST https://ai-tokenhub.com/api/v1/responses

授权 (Authorizations)

BearerAuth

名称类型必填说明
AuthorizationstringBearer token 认证。使用你的API密钥或平台认证token,虚拟密钥(以 sk-bf- 为前缀)也可以在此处传递。格式为:Bearer YOUR_API_KEY
Content-Typestringapplication/json

请求体

application/json

参数类型必填默认值说明
modelstring-模型标识符,格式为 provider/model (例如:doubao-seed-2-0-pro
示例:"doubao-seed-2-0-pro"
inputstring/object[]-输入内容,可以是文本字符串或消息数组
streambooleanfalse是否启用流式响应
temperaturenumber0.7生成温度,取值范围:-2 <= x <= 2
frequency_penaltynumber0频率惩罚,取值范围:-2 <= x <= 2
presence_penaltynumber0存在惩罚,取值范围:-2 <= x <= 2
max_tokensinteger-最大生成 token 数
metadataobject-用户自定义元数据
parallel_tool_callsbooleantrue是否启用并行工具调用
tool_choicestring/object"auto"工具调用选择策略
toolsobject[]-可用工具列表
top_pnumber0.9核采样参数
userstring-用户标识

请求示例

bash
curl https://ai-tokenhub.com/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seed-2-0-pro",
    "input": "Tell me a joke about computers",
    "temperature": 0.7
  }'
python
from openai import OpenAI
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://ai-tokenhub.com/api/v1"
)
response = client.responses.create(
    model="doubao-seed-2-0-pro",
    input="Tell me a joke about computers",
    temperature=0.7
)
print(response.output[0].content[0].text)
javascript
import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://ai-tokenhub.com/api/v1'
});
const response = await client.responses.create({
  model: 'doubao-seed-2-0-pro',
  input: 'Tell me a joke about computers',
  temperature: 0.7
});
console.log(response.output[0].content[0].text);
java
import okhttp3.*;
import java.io.IOException;
public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();
        String json = "{\"model\":\"doubao-seed-2-0-pro\"," +
                      "\"input\":\"Tell me a joke about computers\"," +
                      "\"temperature\":0.7}";
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(json, mediaType);
        Request request = new Request.Builder()
            .url("https://ai-tokenhub.com/api/v1/responses")
            .post(body)
            .addHeader("Content-Type", "application/json")
            .addHeader("Authorization", "Bearer YOUR_API_KEY")
            .build();
        try (Response response = client.newCall(request).execute()) {
            System.out.println(response.body().string());
        }
    }
}

响应示例

json
{
  "completed_at": 1700000300,
  "created_at": 1700000000,
  "error": null,
  "frequency_penalty": 0.5,
  "id": "resp_abc123",
  "incomplete_details": null,
  "instructions": [
    {
      "content": "Tell me a joke about computers",
      "role": "user"
    }
  ],
  "metadata": {},
  "model": "doubao-seed-2-0-pro",
  "object": "response",
  "parallel_tool_calls": true,
  "presence_penalty": 0.3,
  "status": "completed",
  "temperature": 0.7,
  "tool_choice": "auto",
  "tools": [],
  "top_p": 0.9,
  "output": [
    {
      "type": "message",
      "content": [
        {
          "text": "Why do programmers prefer dark mode? Because light attracts bugs!",
          "type": "output_text"
        }
      ],
      "id": "msg-xyz789",
      "role": "assistant"
    }
  ],
  "usage": {
    "input_tokens": 15,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 20,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 35
  }
}