OpenAI çok modlu yanıtları

OpenAI uyumlu Responses API. Bu uç nokta OpenAI tarzı input kullanır; metin, herkese açık görsel URL’leri, PDF dosya girdisi, araç çağrıları, akıl yürütme seçenekleri ve akış parametrelerini destekler.

POST https://api.apihop.ai/openai/responses

Kimlik doğrulama

Tüm istekler Bearer belirteciyle kimlik doğrulama gerektirir.

Authorization: Bearer YOUR_API_KEY

İstek gövdesi

Model parametresi farkları

• Yerel OpenAI uyumlu Responses iletimi, üst sağlayıcı isteğinde top_p korur; doğrulama ve örnekleme davranışı seçilen modele ve üst sağlayıcıya bağlıdır. 2026-09-26 kontrolleri gpt-5.5, gpt-5.6-sol ve gpt-5.6-terra için top_p: 0.9 kabul etti. Kabul ve iletim, örnekleme etkisini kanıtlamaz veya diğer değerler, modeller ya da sonraki istekler için desteği garanti etmez. Asgari istekle başlayın.
• Bu sayfadaki destek yalnızca normal /openai/responses uç noktasına uygulanır. Aynı modelin /openai/responses/compact, WebSocket veya durum tutan previous_response_id desteklediği anlamına gelmez.
• Yukarıdaki beş GPT modelinin şu anda doğrulanmış Compact kanalı yoktur. Açıkça etkinleştirilmiş kanal bulunmadığında Compact istekleri faturalandırmadan önce reddedilir. Normal Responses ve Responses WebSocket kullanılabilir olmaya devam eder.

İstek örnekleri

Aşağıdaki örnekler input sağlar. Devam isteği geçerli previous_response_id sağlıyor ve seçilen kanal durumlu devamı destekliyorsa input atlanabilir. Yanıt kimliği, desteklenmeyen kanalda bu yeteneği etkinleştirmez. function_call_output dahil araç sonuçları geçerli girdi öğeleridir.

Metin

{
  "model": "gpt-5.4",
  "input": "Hello, introduce yourself in one sentence."
}

Codex CLI tarzı parametreler

{
  "model": "gpt-5.5",
  "input": "Reply with READY only.",
  "reasoning": {
    "effort": "xhigh"
  },
  "store": false,
  "text": {
    "verbosity": "low"
  },
  "stream": true
}

Görsel anlama

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "What is in this image?"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/cat.png",
          "detail": "high"
        }
      ]
    }
  ]
}

Dosya girdisi

PDF içeriği göndermek için file_data ve filename kullanın. file_data tam bir veri URL’si olmalıdır.

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Summarize the key points in this PDF."
        },
        {
          "type": "input_file",
          "file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
          "filename": "report.pdf"
        }
      ]
    }
  ]
}

Görsel ve dosya girdisi

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Give three conclusions based on the image and attachment."
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/chart.png",
          "detail": "high"
        },
        {
          "type": "input_file",
          "file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
          "filename": "notes.pdf"
        }
      ]
    }
  ]
}

Akışlı çıktı

{
  "model": "gpt-5.4",
  "stream": true,
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain this diagram step by step."
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/diagram.png"
        }
      ]
    }
  ]
}

Yanıt

Akışsız yanıtlar OpenAI Responses tarzını izler. Gerçek alanlar seçilen modelin yeteneklerine göre değişebilir.

Başarılı yanıt örneği

{
  "id": "resp_123",
  "object": "response",
  "created_at": 1766534400,
  "model": "gpt-5.4",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "text": "The image shows a cat, and the attachment is a document about pet care."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 128,
    "output_tokens": 42,
    "total_tokens": 170
  }
}

Akışlı yanıt

stream=true olduğunda uç nokta Server-Sent Events döndürür.

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"The image"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_123"}}

response.completed gelene veya bağlantı kapanana kadar olayları okuyun.

Hata yanıtı

Tam kod başvurusu, protokol farkları ve tanılama adımları için Hata kodları ve sorun giderme sayfasına bakın.

Platformun ürettiği HTTP hataları error sarmalayıcısı yerine aşağıdaki düz alanları kullanır. Bazı üst sağlayıcı hataları özgün yapılarını koruyabilir; başlamış SSE akışındaki hatalar bu HTTP yanıt örneğini izlemez.

{
  "code": 40000,
  "message": "Insufficient credit. Required: 30000, Available: 20000",
  "type": "api_error"
}

Notlar

• Responses uç noktası messages değil input kullanır. İstemciniz yalnızca messages gönderiyorsa /openai/v1/chat/completions kullanın.
• Görsel girdisi input_image kullanır; image_url herkese açık http:// veya https:// URL’si olmalıdır. Görsellerde Base64 veri URL’leri desteklenmez.
• Dosya girdisi input_file kullanır. PDF’ler için file_data ve filename kullanın; file_data tam data:application/pdf;base64,... URL’si olmalıdır.
• Ses girdi/çıktısı, görsel oluşturma araçları, dosya arama ve diğer gelişmiş yetenekler seçilen modele ve mevcut özelliklere bağlıdır.
• Bu sayfada listelenen alanlar mevcut genel Responses istek sözleşmesini oluşturur; listelenmeyen alanların kullanılabilir olduğunu varsaymayın.
• /openai/responses önerilen genel yoldur.
• /v1/responses aynı genel istek ve yanıt sözleşmesini izler.
• /compat/v1/responses aynı genel istek ve yanıt sözleşmesini izler.
• /openai/v1/responses aynı genel istek ve yanıt sözleşmesini izler.