接口文档

OpenAI Responses API

测试 BetterToken 面向 Codex 的 OpenAI Responses API：Base URL、Bearer API Key 与 POST /v1/responses。

POST /v1/responses

适用于 Codex 与使用 OpenAI Responses API 的应用。

在 Playground 中测试

在右侧 Playground 填入你的 API Key；如有需要，将 model 改为当前可用的模型 ID，然后发送请求。测试前请在模型广场确认模型。

授权

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

请求体 application/json

modelstring必填

模型广场中可用的模型 ID。请以模型广场当前显示的模型为准。

示例:"YOUR_MODEL_ID"

inputstring必填

发送给模型的文本输入。

示例:"Hello"

响应

200所选模型返回的 Responses API 响应。

OpenAI Responses API 的响应。实际字段会随所选模型和请求参数变化。

示例

{}

400请求格式错误、缺少参数、JSON 或 multipart 解析失败、尺寸格式错误。

errorobject

Show child attributes

error.messagestring

示例:"invalid request"

error.typestring

示例:"invalid_request_error"

error.codestring

示例:"invalid_request"

messagestring

示例:"insufficient quota"

示例

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

401API Key 缺失或无效。

errorobject

Show child attributes

error.messagestring

示例:"invalid request"

error.typestring

示例:"invalid_request_error"

error.codestring

示例:"invalid_request"

messagestring

示例:"insufficient quota"

示例

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

402额度或余额不足。

errorobject

Show child attributes

error.messagestring

示例:"invalid request"

error.typestring

示例:"invalid_request_error"

error.codestring

示例:"invalid_request"

messagestring

示例:"insufficient quota"

示例

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

429触发限速、并发限制或上游繁忙。

errorobject

Show child attributes

error.messagestring

示例:"invalid request"

error.typestring

示例:"invalid_request_error"

error.codestring

示例:"invalid_request"

messagestring

示例:"insufficient quota"

示例

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

500网关或上游服务异常。

errorobject

Show child attributes

error.messagestring

示例:"invalid request"

error.typestring

示例:"invalid_request_error"

error.codestring

示例:"invalid_request"

messagestring

示例:"insufficient quota"

示例

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

import requests url = "https://bettertoken.ai/v1/responses" payload = { "model": "YOUR_MODEL_ID", "input": "Hello" } headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: JSON.stringify({model: 'YOUR_MODEL_ID', input: 'Hello'}) }; fetch('https://bettertoken.ai/v1/responses', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));

<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://bettertoken.ai/v1/responses", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'model' => 'YOUR_MODEL_ID', 'input' => 'Hello' ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer <token>", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }

package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://bettertoken.ai/v1/responses" payload := strings.NewReader("{\n \"model\": \"YOUR_MODEL_ID\",\n \"input\": \"Hello\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) }

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1/responses") .header("Authorization", "Bearer <token>") .header("Content-Type", "application/json") .body("{\n \"model\": \"YOUR_MODEL_ID\",\n \"input\": \"Hello\"\n}") .asString();

require 'uri' require 'net/http' url = URI("https://bettertoken.ai/v1/responses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer <token>' request["Content-Type"] = 'application/json' request.body = "{\n \"model\": \"YOUR_MODEL_ID\",\n \"input\": \"Hello\"\n}" response = http.request(request) puts response.read_body

OpenAI Responses API

在 Playground 中测试

相关接口

授权

请求体 application/json

响应