OpenAI मल्टीमोडल Responses

OpenAI-संगत Responses API। यह एंडपॉइंट OpenAI-शैली input इस्तेमाल करता है और पाठ, सार्वजनिक चित्र URL, PDF फ़ाइल इनपुट, टूल कॉल, तर्क-विचार विकल्प तथा स्ट्रीमिंग पैरामीटर समर्थित करता है।

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

प्रमाणीकरण

सभी अनुरोधों में Bearer Token प्रमाणीकरण आवश्यक है।

Authorization: Bearer YOUR_API_KEY

अनुरोध बॉडी

मॉडल पैरामीटर में अंतर

• मूल OpenAI-संगत Responses फ़ॉरवर्डिंग अपस्ट्रीम अनुरोध में top_p रखती है; सत्यापन और सैंपलिंग व्यवहार चुने मॉडल और अपस्ट्रीम पर निर्भर हैं। 2026-09-26 की जाँचों में gpt-5.5, gpt-5.6-sol और gpt-5.6-terra के लिए top_p: 0.9 स्वीकार हुआ। स्वीकृति और फ़ॉरवर्डिंग सैंपलिंग प्रभाव या दूसरे मान, मॉडल अथवा बाद के अनुरोधों के समर्थन की गारंटी नहीं। न्यूनतम अनुरोध से शुरू करें।
• इस पृष्ठ का समर्थन केवल सामान्य /openai/responses एंडपॉइंट पर लागू है। इससे उसी मॉडल में /openai/responses/compact, WebSocket या स्थिति-सहित previous_response_id का समर्थन नहीं माना जा सकता।
• ऊपर के पाँच GPT मॉडल का फिलहाल सत्यापित Compact चैनल नहीं है। स्पष्ट चालू चैनल न हो तो Compact अनुरोध बिलिंग से पहले अस्वीकार होते हैं। सामान्य Responses और Responses WebSocket उपलब्ध रहते हैं।

अनुरोध उदाहरण

नीचे के उदाहरण input देते हैं। वैध previous_response_id देने और चुने चैनल में स्थिति-सहित निरंतरता समर्थित होने पर आगे की बातचीत में input छोड़ा जा सकता है। उत्तर ID असमर्थित चैनल पर यह क्षमता चालू नहीं करती। टूल परिणाम वैध इनपुट आइटम रहते हैं, जिनमें function_call_output भी है।

टेक्स्ट

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

Codex CLI-शैली पैरामीटर

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

चित्र समझ

{
  "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"
        }
      ]
    }
  ]
}

फ़ाइल इनपुट

PDF सामग्री भेजने के लिए file_data के साथ filename दें। file_data पूरा Data URL होना चाहिए।

{
  "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"
        }
      ]
    }
  ]
}

चित्र और फ़ाइल इनपुट

{
  "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"
        }
      ]
    }
  ]
}

स्ट्रीमिंग आउटपुट

{
  "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"
        }
      ]
    }
  ]
}

उत्तर

नॉन-स्ट्रीमिंग उत्तर OpenAI Responses शैली अपनाते हैं। वास्तविक फ़ील्ड चुने मॉडल की क्षमताओं से बदल सकते हैं।

सफलता उदाहरण

{
  "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
  }
}

स्ट्रीमिंग उत्तर

stream=true होने पर एंडपॉइंट Server-Sent Events लौटाता है।

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 या कनेक्शन बंद होने तक इवेंट पढ़ें।

त्रुटि उत्तर

पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।

प्लेटफ़ॉर्म-निर्मित HTTP त्रुटियाँ error आवरण के बजाय नीचे के समतल फ़ील्ड इस्तेमाल करती हैं। कुछ अपस्ट्रीम त्रुटियाँ मूल संरचना रख सकती हैं; शुरू हो चुकी SSE स्ट्रीम की त्रुटियाँ यह HTTP उत्तर उदाहरण नहीं अपनातीं।

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

ध्यान देने योग्य बातें

• Responses एंडपॉइंट में input है, messages नहीं। क्लाइंट केवल messages भेजता हो तो /openai/v1/chat/completions लें।
• चित्र इनपुट में input_image है; image_url सार्वजनिक http:// या https:// URL होना चाहिए। चित्रों के लिए Base64 Data URL समर्थित नहीं हैं।
• फ़ाइल इनपुट में input_file है। PDF के लिए file_data के साथ filename दें; file_data पूरा data:application/pdf;base64,... URL होना चाहिए।
• ऑडियो इनपुट/आउटपुट, चित्र जनरेशन टूल, फ़ाइल खोज और दूसरी उन्नत क्षमताएँ चुने मॉडल और उपलब्ध सुविधाओं पर निर्भर हैं।
• इस पृष्ठ के फ़ील्ड वर्तमान सार्वजनिक Responses अनुरोध अनुबंध बनाते हैं; सूची से बाहर के फ़ील्ड उपलब्ध न मानें।
• /openai/responses सुझाया सार्वजनिक पथ है।
• /v1/responses वही सार्वजनिक अनुरोध और उत्तर अनुबंध अपनाता है।
• /compat/v1/responses वही सार्वजनिक अनुरोध और उत्तर अनुबंध अपनाता है।
• /openai/v1/responses वही सार्वजनिक अनुरोध और उत्तर अनुबंध अपनाता है।