Responses

认证和模型列表请参考概述。

端点

POST https://api.pipellm.ai/v1/responses

这条 free route 只接受 OpenAI Responses 格式请求，并只路由到 OpenAI 兼容平台。Responses API 目前还不支持跨协议 converter 路由。如果你今天就需要跨协议调用，请先使用 OpenAI Format Converter 对应的 Chat Completions 路由。

代码示例

cURL
Python
TypeScript

curl https://api.pipellm.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PIPELLM_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "input": "用一句话解释为什么天空是蓝色的。"
  }'

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("PIPELLM_API_KEY"),
  base_url="https://api.pipellm.ai/v1"
)

response = client.responses.create(
  model="gpt-4.1",
  input="用一句话解释为什么天空是蓝色的。"
)

print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PIPELLM_API_KEY,
  baseURL: "https://api.pipellm.ai/v1",
});

const response = await client.responses.create({
  model: "gpt-4.1",
  input: "用一句话解释为什么天空是蓝色的。",
});

console.log(response.output_text);

常见请求字段

字段	类型	必需	说明
`model`	string	是	OpenAI 兼容模型 ID
`input`	string 或 array	是	文本输入，或结构化输入项数组
`instructions`	string	否	developer 或 system 指令
`stream`	boolean	否	是否启用流式输出
`tools`	array	否	内置工具或自定义工具
`temperature`	number	否	采样温度
`max_output_tokens`	integer	否	最大输出 token 数

响应结构

{
  "id": "resp_123",
  "object": "response",
  "model": "gpt-4.1",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "大气层对蓝光的散射比红光更强。"
        }
      ]
    }
  ]
}

路由与协议

先理解原生路由的协议限制

OpenAI 总览

PipeLLM 上的 OpenAI 兼容端点

OpenAI 迁移指南

官方 Responses 与 Chat Completions 对比

总览

使用 API

OpenAI 兼容

Anthropic

Gemini

端点

代码示例

常见请求字段

响应结构

相关文档

路由与协议

OpenAI 总览

OpenAI 迁移指南

总览

使用 API

OpenAI 兼容

Anthropic

Gemini

​端点

​代码示例

​常见请求字段

​响应结构

​相关文档

路由与协议

OpenAI 总览

OpenAI 迁移指南

端点

代码示例

常见请求字段

响应结构

相关文档