Yanıt Oluştur

OpenAI Responses API formatını kullanarak bir yanıt oluşturur

Responses API, OpenAI’nin daha yeni durumlu konuşma API’sidir. LemonData bu formatı uyumlu modeller için gelişmiş isteğe bağlı bir yol olarak destekler; Responses’a özgü davranışlara açıkça ihtiyacınız olmadıkça varsayılan OpenAI-uyumlu yol olarak POST /v1/chat/completions kullanın.

​

İstek Gövdesi

model · string · gerekli

Kullanılacak modelin ID’si. Mevcut seçenekler için Models sayfasına bakın.

input · array · gerekli

Konuşmayı oluşturan giriş öğelerinin listesi.

Her öğe şunlardan biri olabilir:

• message: rol ve içerik içeren bir konuşma mesajı
• function_call: bir fonksiyon çağrısı isteği
• function_call_output: bir fonksiyon çağrısından gelen çıktı

Multimodal giriş için, message.content ya düz bir string ya da içerik blokları dizisi olabilir. GPT-5.4 gibi görsel işleme yeteneği olan modeller için resimleri doğrudan düz metin içine URL veya Base64 dizeleri yerleştirmek yerine input_image blokları olarak iletin.

Örnek içerik blokları:

• { "type": "input_text", "text": "Describe this image" }
• { "type": "input_image", "image_url": "https://example.com/image.jpg" }
• { "type": "input_image", "image_url": "data:image/png;base64,..." }

instructions · string

Model için sistem talimatları (system message ile eşdeğer).

max_output_tokens · integer

Üretilmesi gereken maksimum token sayısı.

temperature · number · varsayılan: "1"

0 ile 2 arasında örnekleme sıcaklığı.

tools · array

Modelin çağırabileceği araçların listesi.

Varsayılan görüntü aracı modelini kullanan veya açıkça model: "gpt-image-2" ayarlayan hosted image_generation araçlarında LemonData, isteği iletmeden önce desteklenmeyen input_fidelity alanını kaldırır; çünkü GPT Image 2 görüntü girdilerini zaten yüksek sadakatle işler. Bu araç için background: "transparent" göndermeyin; LemonData bunu sessizce kaldırmaz, çünkü çıktı semantiği değişir.

stream · boolean · varsayılan: "false"

Eğer true ise, olayların bir akışını döndürür.

previous_response_id · string

Konuşmaya devam etmek için önceki bir yanıtın ID’si.

store · boolean · varsayılan: "true"

Yanıtın daha sonra alınmak üzere depolanıp depolanmayacağı.

metadata · object

İzleme amaçlı yanıtla iliştirilecek metadata.

text · object

Metin üretimi yapılandırma seçenekleri. text.format davranışı seçilen model ve yönlendirilen yola bağlıdır; her modelde aynı şekilde garanti edilmez.

parallel_tool_calls · boolean · varsayılan: "true"

Birden fazla araç çağrısına paralel izin verilip verilmeyeceği.

top_p · number

Nucleus örnekleme parametresi (0-1).

reasoning · object

GPT-5 ailesi varyantları gibi akıl yürütme etkin modeller için akıl yürütme yapılandırması.

• effort (string): Akıl yürütme çabası seviyesi (low, medium, high)

​

Yanıt

id · string

Yanıt için benzersiz tanımlayıcı.

object · string

Her zaman response.

created · integer

Yanıtın oluşturulduğu zamanın Unix zaman damgası.

output · array

Model tarafından oluşturulan çıktı öğelerinin listesi.

usage · object

Token kullanım istatistikleri.

cURL

curl -X POST "https://api.lemondata.cc/v1/responses" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": [
      {"type": "message", "role": "user", "content": "Hello!"}
    ],
    "max_output_tokens": 1000
  }'

Response

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1706000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "text", "text": "Hello! How can I help you today?"}
      ]
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "total_tokens": 22
  }
}