Responses API (OpenAI uyumlu)

OpenAI POST /v1/responses ile uyumlu. input alanı string ya da mesaj dizisi olabilir; maskeleme açıkken her iki biçimde de tespit edilen PII alanları model çağrısından önce yer tutuculara dönüştürülür. Maskeleme adımı çalıştırılamazsa istek fail-closed olarak modele gitmeden durur.

POST/v1/responses

Request body

requiredapplication/json

modelstringrequired

Hedef model kimliği (panelde tanımlı).

inputstring | ChatMessage[]required

String ya da mesaj dizisi. Maskeleme açıkken her iki biçimde de tespit edilen kişisel alanlar model çağrısından önce gateway içinde yer tutuculara dönüştürülür.

Show properties

One of:

string

string

ChatMessage[]

Array of ChatMessage

rolestringrequired

Allowed:systemuserassistanttool

contentstringrequired

Mesaj metni. Maskeleme açıkken tüm rollerin (`system`, `user`, `assistant`, `tool`) içeriğinde tespit edilen kişisel alanlar gateway içinde yer tutuculara dönüştürülür.

streamboolean

default: false

temperaturenumber

min 0 · max 2

max_output_tokensinteger

Üretilecek azami token sayısı.

min 1

Responses

200Başarılı yanıt

idstring

objectstring

created_atinteger

modelstring

statusstring

outputResponsesOutputItem[]

Show properties

Array of ResponsesOutputItem

idstring

typestring

statusstring

rolestring

contentResponsesContentPart[]

Show properties

Array of ResponsesContentPart

typestring

textstring

annotationsobject[]

usageUsage

Show properties

prompt_tokensinteger

completion_tokensinteger

total_tokensinteger

401Eksik veya geçersiz sanal anahtar

errorobject

Show properties

messagestring

typestring

413Girdi maskeleme sınırını aşıyor. İstek modele iletilmez; metni bölüp yeniden gönderin.

errorobject

Show properties

messagestring

typestring

429Kota/oran limiti aşıldı

errorobject

Show properties

messagestring

typestring

502Maskeleme adımı çalıştırılamadı. İstek **fail-closed** olarak modele iletilmez; "maskesiz de olsa gönder" seçeneği yoktur.

errorobject

Show properties

messagestring

typestring

Request

from openai import OpenAI

client = OpenAI(
    base_url="https://gw-tr.gurubase.io/v1",
    api_key="SANAL_ANAHTAR",
)

resp = client.responses.create(
    model="gpt-4o-mini",
    input="Ahmet Yılmaz, TCKN 10000000382, adres değişikliği istiyor.",
)
print(resp.output_text)

import requests

response = requests.post(
    "https://gw-tr.gurubase.io/v1/responses",
    headers={
        "Content-Type": "application/json"
    },
    json={
  "model": "gpt-4o-mini",
  "input": "Ahmet Yılmaz, TCKN 10000000382, talebini iletti.",
  "stream": False,
  "temperature": 0,
  "max_output_tokens": 0
},
)

curl -X POST "https://gw-tr.gurubase.io/v1/responses" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-4o-mini",
  "input": "Ahmet Yılmaz, TCKN 10000000382, talebini iletti.",
  "stream": false,
  "temperature": 0,
  "max_output_tokens": 0
}'

const response = await fetch("https://gw-tr.gurubase.io/v1/responses", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "gpt-4o-mini",
  "input": "Ahmet Yılmaz, TCKN 10000000382, talebini iletti.",
  "stream": false,
  "temperature": 0,
  "max_output_tokens": 0
})
});

Response

{
  "id": "resp_01ec5099f62feeda",
  "object": "response",
  "created_at": 1782136928,
  "model": "gpt-4o-mini",
  "status": "completed",
  "output": [
    {
      "id": "msg_01ec5099f62feeda",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Kayıt alındı.",
          "annotations": [
            {}
          ]
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}