إنشاء إكمال محادثة

جسم الطلب · application/json

النوع

object

الحقول المطلوبة

modelmessages

جسم الطلب مطلوب

• modelstringمطلوب

  معرّف النموذج

• messagesarrayمطلوب

  قائمة رسائل المحادثة

  الحقول الفرعية لـ messages (1)

  • []objectاختياري
    الحقول الفرعية لـ [] (6)

    • rolestringمطلوب

      دور الرسالة

      القيم المعدودة

      ["system","user","assistant","tool","developer"]

    • contentunionمطلوب

      محتوى الرسالة

      فرع oneOf رقم 1

      النوع: string
      فرع oneOf رقم 2

      النوع: array

      • []objectاختياري
        الحقول الفرعية لـ [] (6)

        • typestringاختياري

          القيم المعدودة

          ["text","image_url","input_audio","file","video_url"]

        • textstringاختياري

        • image_urlunionاختياري

          يدعم مدخلات منقولة كسلسلة URL/Base64 أو كائن {url, detail}. متاح فقط للنماذج التي تدعم إدخال الصور؛ وليس ضمانًا بأن جميع النماذج تدعم الرؤية.

          فرع oneOf رقم 1

          رابط صورة أو رابط بيانات Base64.

          النوع: string
          فرع oneOf رقم 2

          يجب أن تتضمن مدخلات الكائن url على الأقل. يحوّل Message.ParseContent قيمة detail المحذوفة إلى high؛ ويعتمد الدعم على نموذج الرؤية المختار.

          النوع: object

          المطلوب في هذا الفرع: url

          • urlstringمطلوب

            رابط صورة أو base64

          • detailstringاختياري

            القيم المعدودة

            ["low","high","auto"]

        • input_audioobjectاختياري
          الحقول الفرعية لـ input_audio (2)

          • datastringاختياري

            بيانات صوتية مرمّزة بـ Base64

          • formatstringاختياري

            القيم المعدودة

            ["wav","mp3"]

        • fileobjectاختياري
          الحقول الفرعية لـ file (3)

          • filenamestringاختياري

          • file_datastringاختياري

          • file_idstringاختياري

        • video_urlstringاختياري

          المدخل الفعلي المنقول الذي يقرؤه Message.ParseContent هو سلسلة رابط فيديو، وهو متاح فقط للنماذج التي تدعم إدخال الفيديو. لا يدخل كائن {url: ...} في نتائج المحتوى/القياس لهذا المحلّل، ولا يُنشر بوصفه عقدًا صالحًا للاستخدام.

    • namestringاختياري

      اسم المرسل

    • tool_callsarrayاختياري
      الحقول الفرعية لـ tool_calls (1)

      • []objectاختياري
        الحقول الفرعية لـ [] (3)

        • idstringاختياري

        • typestringاختياري

        • functionobjectاختياري
          الحقول الفرعية لـ function (2)

          • namestringاختياري

          • argumentsstringاختياري

    • tool_call_idstringاختياري

      معرّف استدعاء الأداة (للرسائل ذات دور tool)

    • reasoning_contentstringاختياري

      محتوى الاستدلال

• temperaturenumberاختياري

  درجة حرارة أخذ العينات. يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• top_pnumberاختياري

  معامل أخذ العينات النووي. يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• nintegerاختياري

  عدد العناصر المطلوب توليدها. يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• streambooleanاختياري

  هل تُبث الاستجابة تدريجيًا

  القيمة الافتراضية

  false

• stream_optionsobjectاختياري

  خيارات الاستخدام في بث Chat؛ يعتمد الدعم وإرجاع بيانات الاستخدام على النموذج المختار.

  الحقول الفرعية لـ stream_options (1)

  • include_usagebooleanاختياري

• stopunionاختياري

  تسلسلات التوقف

  فرع oneOf رقم 1

  النوع: string
  فرع oneOf رقم 2

  النوع: array

  • []stringاختياري

• max_tokensintegerاختياري

  الحد الأقصى لعدد الرموز المولّدة. يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• max_completion_tokensintegerاختياري

  الحد الأقصى لعدد رموز الإكمال. يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• presence_penaltynumberاختياري

  يعتمد الدعم والحدود على النموذج المختارين؛ لا تُضمن قيم افتراضية موحدة.

• frequency_penaltynumberاختياري

  يعتمد الدعم والحدود على النموذج المختارين؛ لا تُضمن قيم افتراضية موحدة.

• logit_biasobjectاختياري
  الحقول الفرعية لـ logit_bias (1)

  • [key]numberاختياري

• userstringاختياري

• toolsarrayاختياري
  الحقول الفرعية لـ tools (1)

  • []objectاختياري
    الحقول الفرعية لـ [] (2)

    • typestringاختياري

    • functionobjectاختياري
      الحقول الفرعية لـ function (3)

      • namestringاختياري

      • descriptionstringاختياري

      • parametersobjectاختياري

        تعريف المعاملات بتنسيق JSON Schema

• tool_choiceunionاختياري
  فرع oneOf رقم 1

  النوع: string

  القيم المعدودة: ["none","auto","required"]
  فرع oneOf رقم 2

  النوع: object

  • typestringاختياري

  • functionobjectاختياري
    الحقول الفرعية لـ function (1)

    • namestringاختياري

• response_formatobjectاختياري
  الحقول الفرعية لـ response_format (2)

  • typestringاختياري

    القيم المعدودة

    ["text","json_object","json_schema"]

  • json_schemaobjectاختياري

    تعريف JSON Schema

• seedintegerاختياري

  يعتمد الدعم والحدود على النموذج المختارين؛ لا تُضمن قيم افتراضية موحدة.

• reasoning_effortstringاختياري

  جهد الاستدلال (للنماذج التي تدعم الاستدلال). يعتمد الدعم والحدود المحددان على النموذج المختارين؛ ولا تُضمن قيم افتراضية موحدة.

• modalitiesarrayاختياري
  الحقول الفرعية لـ modalities (1)

  • []stringاختياري

    القيم المعدودة

    ["text","audio"]

• audioobjectاختياري
  الحقول الفرعية لـ audio (2)

  • voicestringاختياري

  • formatstringاختياري

• parallel_tool_callsbooleanاختياري

  يعتمد السماح باستدعاءات الأدوات المتوازية على النموذج المختار. يقبل Chat قيمة منطقية، وتقبل Responses قيم JSON للبروتوكول المتوافق.

• storebooleanاختياري

  يعتمد السماح بحفظ الطلبات والاستجابات على النموذج المختار وإمكانات الخدمة المدعومة. لا يوفر هذا واجهة عامة لتخزين المحادثات.

• prompt_cache_keystringاختياري

  معرّف ربط ذاكرة التوجيهات لدى الخدمة، حسب النموذج ودون ضمان الدعم أو الإصابة. يقبل Chat سلسلة نصية، وتقبل Responses قيمة JSON للبروتوكول.

• prompt_cache_retentionunknownاختياري

  قيمة JSON لضبط احتفاظ ذاكرة توجيهات الخدمة، حسب النموذج. لا تمنح المنصة تعدادًا أو افتراضيًا موحدًا أو ضمان احتفاظ.

• service_tierunknownاختياري

  مستوى الخدمة المطلوب، وقد يؤثر في التكلفة. يُتجاهل افتراضيًا ولا يسري إلا عند دعمه. تعتمد القيم المقبولة على النموذج المختار.

HTTP 200

{
  "type": "string",
  "description": "SSE 事件流，协议事件/用量/结束符取当前接口，错误可能在流内。"
}

HTTP 400

HTTP 401

HTTP 403

HTTP 429

HTTP 500