GPT Responses

Call GPT-6.1 Sol, GPT-6 Astra, GPT-6 Sol and GPT-6 Luna through the OpenAI Responses API with a BeatAPI key.

• One endpoint, POST /v1/responses, for every current GPT model. Change model to switch.
• The recommended format for new reasoning and tool-calling integrations.
• Text and image input, text output, streaming, function calling, structured outputs and configurable reasoning effort.
• Works with the OpenAI SDK: change the base URL and use a BeatAPI key. For an existing Chat Completions integration, see Chat Completions.

Opens this endpoint in the API Explorer. Enter your BeatAPI API key and send: the call is real and is billed to your own balance.

Models

Send one of these IDs as model. Each is a separate model; do not treat them as aliases of each other.

• Prices are the base tier, discount already applied. A long-context tier, cached-input rates and cache writes are not in this table; see the price table.
• — means the catalogue does not publish the number.

Older IDs of this family still work and are listed on Legacy models.

Quick start

Install the openai package on your server, keep the key in BEATAPI_API_KEY, and never put it in browser code. output_text is the SDK’s shortcut for the answer text.

Reasoning effort accepts none, low, medium, high, xhigh and max on the GPT-5.6 models; gpt-6.1-sol accepts low to max. Use medium as a balanced starting point, then evaluate one level lower and higher on your own workload. An HTTP 200 alone does not prove the answer satisfies your task: validate it in your application.

curl --request POST \
  --url https://direct.beatapi.io/v1/responses \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6.1-sol",
  "input": "Design a resilient webhook retry strategy for a payments API.",
  "reasoning": {
    "effort": "medium"
  }
}'

Endpoint and authentication

POST https://direct.beatapi.io/v1/responses

Request parameters

Standard OpenAI Responses fields are accepted. Request-format compatibility does not mean every provider-specific option or hosted tool is supported, so test the options you rely on.

{ "effort": "medium" }

Response

A non-streaming call returns one JSON object. This is an abbreviated example.

{
  "id": "resp_example",
  "object": "response",
  "model": "gpt-6.1-sol",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 19,
    "output_tokens": 16,
    "total_tokens": 35
  }
}

Response fields

Streaming

Set "stream": true. BeatAPI forwards the server-sent event stream without converting it, so event names and objects stay compatible with the OpenAI SDK.

• The response is text/event-stream; without streaming it is application/json.
• A failure before the model is called is returned as a normal JSON error with an HTTP status, not as a stream event.
• Set explicit timeouts and reconnect a streamed response safely.

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Retry"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":" with backoff"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","status":"completed"}}

Errors

HTTP errors at a glance

Authentication, routing, rate-limit and unknown-model failures are answered before the model is called, in the BeatAPI envelope: error.code, error.message, retryable, request_id. Every other failure keeps the OpenAI SDK shape {"error": {"message", "type", "code"}}: the code is in error.code and the request id ends message. See Errors.

Full code table and retry policy: Errors.

Notes

• Claude models do not answer on /v1/responses (400 bad_request); call them on Anthropic Messages.
• Above 272K input tokens, gpt-6.1-sol and gpt-6-astra use a higher tier for the full request. See the price table before budgeting a long-context workload.
• Keep API keys on trusted servers, log the response request ID, and retry only 429, 500 and 503.