Responses

curl --request POST \
  --url https://api.redpill.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {},
  "tools": [
    {}
  ],
  "temperature": 123,
  "top_p": 123,
  "provider": {}
}
'

import requests

url = "https://api.redpill.ai/v1/responses"

payload = {
    "model": "<string>",
    "input": {},
    "tools": [{}],
    "temperature": 123,
    "top_p": 123,
    "provider": {}
}
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: '<string>',
    input: {},
    tools: [{}],
    temperature: 123,
    top_p: 123,
    provider: {}
  })
};

fetch('https://api.redpill.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://api.redpill.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' => '<string>',
    'input' => [
        
    ],
    'tools' => [
        [
                
        ]
    ],
    'temperature' => 123,
    'top_p' => 123,
    'provider' => [
        
    ]
  ]),
  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://api.redpill.ai/v1/responses"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\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://api.redpill.ai/v1/responses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.redpill.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\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\n}"

response = http.request(request)
puts response.read_body

POST

responses

Responses

curl --request POST \
  --url https://api.redpill.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {},
  "tools": [
    {}
  ],
  "temperature": 123,
  "top_p": 123,
  "provider": {}
}
'

import requests

url = "https://api.redpill.ai/v1/responses"

payload = {
    "model": "<string>",
    "input": {},
    "tools": [{}],
    "temperature": 123,
    "top_p": 123,
    "provider": {}
}
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: '<string>',
    input: {},
    tools: [{}],
    temperature: 123,
    top_p: 123,
    provider: {}
  })
};

fetch('https://api.redpill.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://api.redpill.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' => '<string>',
    'input' => [
        
    ],
    'tools' => [
        [
                
        ]
    ],
    'temperature' => 123,
    'top_p' => 123,
    'provider' => [
        
    ]
  ]),
  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://api.redpill.ai/v1/responses"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\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://api.redpill.ai/v1/responses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.redpill.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\": \"<string>\",\n  \"input\": {},\n  \"tools\": [\n    {}\n  ],\n  \"temperature\": 123,\n  \"top_p\": 123,\n  \"provider\": {}\n}"

response = http.request(request)
puts response.read_body

Creates a model response using the Responses API request and response format. Like all inference endpoints, requests are served through the attested TEE gateway and return an x-receipt-id header for verification.

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

Request Body

string

required

Model id, for example qwen/qwen3-30b-a3b-instruct-2507 or openai/gpt-4o.

string | array

required

The input prompt. A string, or an array of input items.

array

Tool definitions the model may call.

number

Sampling temperature.

number

Nucleus sampling.

object

Routing constraints for this request, applied together. zdr restricts routing to providers that do not retain content; aci_verified restricts it to an upstream verified inside the TEE; aci_session_ids pins it to specific attested channels.

{"provider": {"aci_verified": true}}

If no provider satisfies the constraints the request fails before the prompt is sent, and failover retries stay inside the allowed set. Field reference: Chat Completions. See Attested routing and Zero data retention.

Example

curl https://api.redpill.ai/v1/responses \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": "Say hello in 3 words."
  }'

Response

{
  "id": "resp_023cda4f5e268c44006a30f3e0b6f4819b87536574ae6ecd14",
  "object": "response",
  "status": "completed",
  "model": "gpt-4o-2024-08-06",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "Hello, howdy, hi!", "annotations": [] }
      ]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 8,
    "total_tokens": 22
  }
}

The output array contains items by type. A message item holds the assistant content; a reasoning item appears for reasoning models. Read assistant text from output[].content[].text on the message item.

Endpoints

Verification

Legacy

Responses

Request Body

Example

Response

Chat Completions

Models

​Request Body

​Example

​Response

​Related

Chat Completions

Models

Request Body

Example

Response

Related