Ana içeriğe atla
POST
/
v1
/
responses
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'
{
  "id": "resp-abc123",
  "object": "response",
  "created_at": 1704067200,
  "status": "completed",
  "model": "openai/gpt-4o",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! I'm doing well, thank you for asking."
        }
      ]
    }
  ],
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "temperature": 1.0,
  "top_p": 1.0,
  "usage": {
    "input_tokens": 15,
    "output_tokens": 12,
    "total_tokens": 27
  }
}
OpenAI Responses API formatını kullanarak akışlı veya akışsız bir yanıt oluşturur.

Kimlik Doğrulama

Authorization
string
gerekli
Bearer token. Authorization başlığında API anahtarınızı bearer token olarak kullanın.Format: Bearer <SUNRA_KEY>

İstek

Bu endpoint bir JSON nesnesi bekler.
model
string
gerekli
Yanıt üretmek için kullanılacak model. Mevcut modelleri sunra.ai/models adresinde inceleyin.
input
string | object[]
Yanıt isteği için girdi. Bir dize veya girdi öğeleri dizisi olabilir.
instructions
string
Model için sistem düzeyinde talimatlar. Bir sistem mesajına eşdeğer.
stream
boolean
varsayılan:false
true olarak ayarlanırsa, yanıt server-sent events (SSE) kullanılarak akışla iletilir.
max_output_tokens
integer
Üretilecek maksimum çıkış token sayısı.
temperature
number
0 ile 2 arasında örnekleme sıcaklığı. Yüksek değerler rastgeleliği artırır.
top_p
number
Çekirdek örnekleme parametresi (0-1).
frequency_penalty
number
-2.0 ile 2.0 arasında bir sayı. Tokenleri mevcut sıklıklarına göre cezalandırır.
presence_penalty
number
-2.0 ile 2.0 arasında bir sayı. Tokenleri daha önce görünüp görünmediklerine göre cezalandırır.
store
boolean
varsayılan:true
Üretilen yanıtın daha sonra alınmak üzere saklanıp saklanmayacağı.

Yanıt

Başarılı yanıt nesnesi.
id
string
Benzersiz yanıt tanımlayıcısı.
object
string
Nesne türü. Her zaman response.
created_at
number
Oluşturulma Unix zaman damgası.
status
string
Yanıtın durumu. completed, failed, in_progress veya cancelled olabilir.
model
string
Yanıt için kullanılan model.
output
object[]
Model tarafından üretilen çıkış öğelerinin listesi.
usage
object
Token kullanım istatistikleri.
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'
{
  "id": "resp-abc123",
  "object": "response",
  "created_at": 1704067200,
  "status": "completed",
  "model": "openai/gpt-4o",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! I'm doing well, thank you for asking."
        }
      ]
    }
  ],
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "temperature": 1.0,
  "top_p": 1.0,
  "usage": {
    "input_tokens": 15,
    "output_tokens": 12,
    "total_tokens": 27
  }
}