Text
GPT-6.2 Astra
استخدم GPT-6.2 Astra مع تنسيقي Responses وChat Completions في OpenAI. يتضمن أمثلة على حِزم SDK، والمخرجات المنظّمة، واستدعاءات الدوال، والبثّ.
استخدم gpt-6.2-astra للبرمجة المعقدة وتحليل المستندات. اضبط عنوان URL الأساسي لـSDK OpenAI على https://api.seedrouter.ai/v1 وأدخل مفتاح API الخاص بـSeedRouter.
النموذج والحدود
| الخاصية | GPT-6.2 Astra |
|---|---|
| معرّف النموذج في الطلب | gpt-6.2-astra |
| الإدخال والإخراج | نصوص وصور كمدخلات، ونص كمخرجات |
| نافذة السياق | 1,050,000 رمز |
| الحد الأقصى للإدخال | 922,000 رمز |
| الحد الأقصى للإخراج | 128,000 رمز، بما فيها الاستدلال |
| تاريخ انتهاء المعرفة | 18 مايو 2026 |
تشمل نافذة السياق المدخلات والمخرجات معًا. اختر حدًا للإخراج يتيح مساحة للاستدلال والإجابة الظاهرة. تظهر الأسعار الحالية لكل رمز وتسعيرة السياق الطويل في صفحة النموذج.
Responses
ثبّت حزمة Python openai واضبط SEEDROUTER_API_KEY في بيئتك.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SEEDROUTER_API_KEY"],
base_url="https://api.seedrouter.ai/v1",
max_retries=0,
)
response = client.responses.create(
model="gpt-6.2-astra",
input="Name one consistency check for a double-entry ledger.",
reasoning={"effort": "low"},
max_output_tokens=256,
)
print(response.output_text)أرسل POST /v1/responses عبر الاتصال. اقرأ النص من عناصر output من النوع message، ضمن أجزاء المحتوى من النوع output_text. قد يحتوي عنصر سابق على استدلال أو استدعاء دالة. يجمع output_text في استجابة Python SDK أجزاء النص نيابةً عنك. تحقّق من status وincomplete_details قبل استخدام نتيجة جزئية.
لإرسال صورة، أدرِج جزءًا من النوع input_image في رسالة مستخدم. احذف الحقل العلوي image. يقبل SeedRouter الاستجابات المتزامنة واستجابات البثّ. احذف background_options واترك background دون تعيين. نافذتا الخلفية 2h و8h غير متاحتين.
للاستخدام مع الوكلاء الفرعيين المستضافين، أرسل الترويسة OpenAI-Beta: responses_multi_agent=v1 وكائن multi_agent مع ضبط enabled على true. يحدّد الحقل الاختياري max_concurrent_subagents، وهو عدد صحيح، عدد الوكلاء المتحدرين النشطين، ولا يشمل الوكيل الجذر، وقيمته الافتراضية 3 والحد الأدنى 1. احذف reasoning.summary وmax_tool_calls ما دام التفويض مفعّلًا. يتشارك الوكلاء الفرعيون ميزانية الإخراج. لقراءة الإجابة النهائية، اختر عناصر الرسائل التي تكون قيمة agent.agent_name فيها /root وقيمة phase فيها final_answer. يضيف Playground ترويسة الإصدار التجريبي عند إدخال الكائن في JSON المتقدم.
curl https://api.seedrouter.ai/v1/responses \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "OpenAI-Beta: responses_multi_agent=v1" \
-d '{
"model": "gpt-6.2-astra",
"input": "Ask one subagent to check whether 17 is prime. Give the result.",
"multi_agent": {"enabled": true, "max_concurrent_subagents": 1},
"max_output_tokens": 512
}'Chat Completions
curl https://api.seedrouter.ai/v1/chat/completions \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-astra",
"messages": [{"role": "user", "content": "Name one consistency check for a double-entry ledger."}],
"reasoning_effort": "low",
"max_completion_tokens": 256
}'تتضمن استجابة Chat المكتملة choices[0].message.content. راجع choices[0].finish_reason لمعرفة حدود الإخراج. يعرض Chat usage.prompt_tokens وusage.completion_tokens. أما Responses فيعرض usage.input_tokens وusage.output_tokens.
حقول الطلب حسب نقطة النهاية
| الغرض | Responses | Chat Completions |
|---|---|---|
| الإدخال | input سلسلة نصية أو عناصر إدخال | مصفوفة messages |
| تعليمات المطوّر | instructions لهذا الطلب، أو رسالة إدخال من developer | رسالة developer |
| صورة في رسالة مستخدم | جزء من النوع input_image يتضمن سلسلة نصية image_url | جزء من النوع image_url يتضمن عنوان URL في image_url.url |
| مستوى جهد الاستدلال | reasoning.effort | reasoning_effort |
| ميزانية رموز الإخراج | max_output_tokens | max_completion_tokens |
| تفصيل الإخراج | text.verbosity | verbosity |
| JSON صارم | text.format | response_format.json_schema |
| استدعاءات الدوال | tools, tool_choice, function_call_output | استخدم Responses لاستدعاءات الأدوات GPT-6.2 |
| البث | stream: true، أحداث ذات أنواع محددة | stream: true، أجزاء إكمال Chat |
توصي OpenAI بالبدء باستدلال medium عند إعداد تكامل جديد. استخدم low لإجابة قصيرة. عند الترحيل من none أو minimal، اختر low. احذف temperature وtop_p وعناصر التحكم في احتمالات السجل، بما فيها message.output_text.logprobs في Responses include. دليل ترحيل النموذج
المخرجات المنظّمة
في تنسيق JSON Schema ضمن Responses، توضع name وstrict وschema إلى جانب type. أما في Chat فتُدرج الحقول الثلاثة نفسها داخل response_format.json_schema.
city_format = {
"name": "trip",
"strict": True,
"schema": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
"additionalProperties": False,
},
}
response = client.responses.create(
model="gpt-6.2-astra",
input="Return Paris in the city field.",
text={"format": {"type": "json_schema", **city_format}},
reasoning={"effort": "low"},
max_output_tokens=256,
)
print(response.output_text)لاستخدام المخطط مع Chat Completions، مرّر response_format={"type": "json_schema", "json_schema": city_format}. تحقّق من الاستجابة بحثًا عن رفض أو بلوغ حد الرموز قبل تحليل JSON.
استدعاءات الدوال والبث
في طلب Responses، يوجد كل من name وparameters الخاصين بالدالة مباشرةً ضمن الأداة. يعيد هذا المثال استخدام المخطط أعلاه.
response = client.responses.create(
model="gpt-6.2-astra",
input="Call record_city for Paris.",
tools=[{
"type": "function",
"name": "record_city",
"parameters": city_format["schema"],
"strict": True,
}],
tool_choice={"type": "function", "name": "record_city"},
reasoning={"effort": "low"},
max_output_tokens=256,
)
for item in response.output:
if item.type == "function_call":
print(item.call_id, item.name, item.arguments)في اختبار مباشر لـSeedRouter، أعاد هذا الطلب function_call باسم record_city، مع وسيطات أمكن فك ترميزها إلى {"city":"Paris"}. تحقّق من الوسيطات ونفّذ الدالة في تطبيقك. في طلب Responses التالي، أرسل عناصر الإدخال الأصلية وعناصر الإخراج المعادة، ثم أضف عنصر function_call_output مع call_id المطابق وسلسلة نصية output.
لبث النص مباشرةً، اضبط stream: true. في Responses، اجمع delta من أحداث response.output_text.delta وتحقّق من response.completed أو response.incomplete أو response.failed. في Chat، اجمع choices[].delta.content وتحقّق من سبب الإنهاء النهائي، وتابع القراءة حتى [DONE].
الوصول والأسعار
تحقّق من صلاحية وصول مفتاحك باستخدام GET /v1/models. لمعرفة المجموعات المتاحة، استخدم GET /api/seedrouter/llm/groups?model=gpt-6.2-astra مع مفتاح Bearer نفسه. لاختيار مجموعة من النتائج، أرسل معرّفها في الترويسة الاختيارية X-SeedRouter-Group. عند حذف الترويسة، يُستخدم الاختيار الافتراضي للمفتاح. يمكنك أيضًا الاطلاع على المجموعات المتاحة في ساحة التجربة.
تنزيل OpenAPI · تفاصيل النموذج OpenAI · حقول Responses · حقول Chat · رموز الأخطاء
