TokenPostie 最终用户文档

Responses API

接口

POST /v1/responses
Authorization: Bearer tp_your_api_key
Content-Type: application/json

请求体

字段必填说明
model是GET /v1/models 返回的模型 id
input是非空字符串，或 Responses input Item 数组
instructions否系统或开发者指令
stream否true 时返回 Responses SSE 事件
max_output_tokens否最大输出 token 数
tools否Responses 函数工具定义
tool_choice否auto、none、required 或指定函数
text.format否text、json_object 或 json_schema
reasoning.effort否目标模型支持时传递给上游
parallel_tool_calls否是否允许并行函数调用
store否当前仅支持 false

input Item 支持：

  • message
  • function_call
  • function_call_output
  • 文本内容 input_text
  • URL 图片内容 input_image

文件 ID、OpenAI 托管工具、previous_response_id、Conversations 和 background 模式当前不支持。平台会返回参数错误，不会静默忽略。

非流式示例

curl -X POST "$TOKENPOSTIE_BASE_URL/v1/responses" \
  -H "Authorization: Bearer $TOKENPOSTIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$TOKENPOSTIE_MODEL"'",
    "input": "请用一句话介绍 TokenPostie",
    "store": false
  }'

成功响应的 object 为 response，status 为 completed。文本位于 output 数组的 message Item；函数调用位于独立的 function_call Item。

JavaScript SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TOKENPOSTIE_API_KEY,
  baseURL: `${process.env.TOKENPOSTIE_BASE_URL}/v1`
});

const response = await client.responses.create({
  model: process.env.TOKENPOSTIE_MODEL,
  input: "请用一句话介绍 TokenPostie",
  store: false
});

console.log(response.output_text);

流式事件

stream: true 时返回 text/event-stream。文本请求至少包含以下生命周期事件：

  • response.created
  • response.output_item.added
  • response.output_text.delta
  • response.output_text.done
  • response.output_item.done
  • response.completed

平台在上游流结束并取得终止 usage 后发送 response.completed。

状态边界

TokenPostie 当前不保存 OpenAI response object，因此不能使用 previous_response_id 创建服务端响应链。多轮业务应由客户传回历史 input Item，或使用稳定的 X-TokenPostie-Session-Id 提高上游缓存亲和性。