响应(Responses)
异步任务结果查询接口,用于获取异步推理任务的结果查询,也支持直接同步调用生成内容。
接口地址
POST https://ai-tokenhub.com/api/v1/responses授权 (Authorizations)
BearerAuth
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer token 认证。使用你的API密钥或平台认证token,虚拟密钥(以 sk-bf- 为前缀)也可以在此处传递。格式为:Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求体
application/json
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | - | 模型标识符,格式为 provider/model (例如:doubao-seed-2-0-pro)示例: "doubao-seed-2-0-pro" |
| input | string/object[] | 是 | - | 输入内容,可以是文本字符串或消息数组 |
| stream | boolean | 否 | false | 是否启用流式响应 |
| temperature | number | 否 | 0.7 | 生成温度,取值范围:-2 <= x <= 2 |
| frequency_penalty | number | 否 | 0 | 频率惩罚,取值范围:-2 <= x <= 2 |
| presence_penalty | number | 否 | 0 | 存在惩罚,取值范围:-2 <= x <= 2 |
| max_tokens | integer | 否 | - | 最大生成 token 数 |
| metadata | object | 否 | - | 用户自定义元数据 |
| parallel_tool_calls | boolean | 否 | true | 是否启用并行工具调用 |
| tool_choice | string/object | 否 | "auto" | 工具调用选择策略 |
| tools | object[] | 否 | - | 可用工具列表 |
| top_p | number | 否 | 0.9 | 核采样参数 |
| user | string | 否 | - | 用户标识 |
请求示例
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
}
}