Responses API

​

متى تستخدمها

​

البدء السريع

curl https://api.venice.ai/api/v1/responses \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "input": "Explain why the sky is blue in one sentence.",
    "venice_parameters": { "include_venice_system_prompt": false }
  }'

from openai import OpenAI

client = OpenAI(base_url="https://api.venice.ai/api/v1", api_key="YOUR_VENICE_API_KEY")

response = client.responses.create(
    model="venice-uncensored",
    input="Explain why the sky is blue in one sentence.",
    extra_body={"venice_parameters": {"include_venice_system_prompt": False}},
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.venice.ai/api/v1", apiKey: process.env.VENICE_API_KEY });

const response = await client.responses.create({
  model: "venice-uncensored",
  input: "Explain why the sky is blue in one sentence.",
  venice_parameters: { include_venice_system_prompt: false },
});
console.log(response.output_text);

{
  "id": "resp_...",
  "object": "response",
  "model": "venice-uncensored-1-2",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "id": "msg_...",
      "role": "assistant",
      "status": "completed",
      "content": [{ "type": "output_text", "text": "Sunlight scatters off air molecules...", "annotations": [] }]
    }
  ],
  "usage": { "input_tokens": 18, "output_tokens": 21, "total_tokens": 39 }
}

​

كيف تتم معالجة الطلبات

• أصلي (Native). تُمرَّر طلبات نماذج OpenAI إلى Responses API من OpenAI دون ترجمة. يشمل ذلك كل نماذج openai-* باستثناء openai-gpt-oss-120b. تعود عناصر الاستجابة والمعرّفات والتفكير المنطقي وأحداث البث تمامًا كما تُعيدها OpenAI.
• مُترجَم (Translated). كل النماذج الأخرى، بالإضافة إلى openai-gpt-oss-120b، تمر عبر طبقة ترجمة: تحوّل Venice الطلب إلى طلب Chat Completions، وتشغّله، ثم تحوّل النتيجة مرة أخرى. أي شيء لا يستطيع تنسيق Chat Completions التعبير عنه يُتجاهَل أو يُرفَض. راجع القيود.

​

المحادثات عديمة الحالة

history = [{"role": "user", "content": "What is the weather in Paris? Use the tool."}]
tools = [{
    "type": "function",
    "name": "get_weather",
    "description": "Get the current weather for a city",
    "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]},
}]

first = client.responses.create(model="venice-uncensored", input=history, tools=tools)
call = next(item for item in first.output if item.type == "function_call")

history += first.output
history.append({"type": "function_call_output", "call_id": call.call_id, "output": '{"temp_c": 18}'})

second = client.responses.create(model="venice-uncensored", input=history, tools=tools)
print(second.output_text)

​

الوضع الأصلي

• instructions، وتُطبَّق كما هي مكتوبة.
• المخرجات المهيكلة باستخدام text.format. تتحقق OpenAI من المخططات بصرامة، لذا يُعيد المخطط غير الصالح 400. على سبيل المثال، يتطلب strict: true وجود additionalProperties: false، ويتطلب json_object وجود كلمة “json” في مكان ما من المدخلات.
• أدوات الدوال وtool_choice بصيغة Responses من OpenAI {"type": "function", "name": "..."}، بالإضافة إلى استدعاءات الأدوات المتوازية.
• الأدوات المُنفَّذة لدى العميل: custom (مدخلات حرة)، وnamespace، وtool_search، وapply_patch، وshell وlocal_shell مع بيئة محلية، واستخدام الحاسوب (computer use).
• ملخصات التفكير المنطقي، مُفعَّلة افتراضيًا. تُعيد نماذج التفكير المنطقي دائمًا encrypted_content على عناصر التفكير المنطقي. أرسل تلك العناصر مرة أخرى في input في الدور التالي للحفاظ على سياق التفكير المنطقي للنموذج.
• التخزين المؤقت للمطالبات باستخدام prompt_cache_key. تحصر Venice نطاق المفتاح في حسابك، فلا يشارك ذاكرة التخزين المؤقت مع مستخدمين آخرين أبدًا، وتُعيد مفتاحك الأصلي في الاستجابة.
• مدخلات الصور، بما في ذلك detail: "original"، وinput_file مع file_data المُضمَّنة.
• نماذج Pro (*-pro)، التي تشغّل وضع التفكير المنطقي Pro من OpenAI تلقائيًا.

​

البث

• يُبَث نص التفكير المنطقي كـ response.reasoning.delta، وليس كأحداث ملخص التفكير المنطقي الخاصة بـ OpenAI.
• عند تشغيل بحث الويب، يحمل حدث response.web_search.done نتائج البحث قبل بث الإجابة.

​

معاملات الوضع المترجم

• تُطبَّق instructions كرسالة نظام.
• تُعيد الأدوات المخصصة عناصر custom_tool_call مع input الخام. إذا أعاد النموذج معامِلات أداة مخصصة مشوّهة، أو استدعى أداة غير مُعرَّفة في الطلب، يعود الاستدعاء كـ function_call عادي مع المعامِلات الأصلية، حتى يتمكن عميلك من الإبلاغ عن خطأ في الأداة والمتابعة.
• أثناء بث مدخلات أداة مخصصة، قد لا يصل عنصر الاستدعاء الخاص بها والعناصر اللاحقة إلا بعد اكتمال المدخلات. يرسل البث تعليقات SSE للإبقاء على الاتصال (keep-alive) أثناء الانتظار.
• تُرسَل قيمة الصورة detail: "original" كـ high إلى المزوّدين الذين لا يدعمونها.

​

القيود

​

ذات صلة

• مرجع API لـ POST /responses
• استدعاء الدوال
• نماذج التفكير المنطقي
• دليل الترحيل من OpenAI