Responses
پاسخ متنی با خروجی output_text و قرارداد stateless.
فهرست مستندات ۱۴ بخش
https://api.danaai.ai/v1/responsesمسیرها نسبت به آدرس پایهٔ بالا هستند؛ احراز هویت با کلید دانا انجام می‌شود.
input می‌تواند رشته یا پیام‌های متنی system، developer، user و assistant باشد؛ آخرین پیام گفتگو باید درخواست user باشد. برای تاریخچه، پیام‌های متنی قبلی را در درخواست جدید بفرستید.
store فقط false یا حذف‌شده است. این گزینه نگهداری سوابق حساب، متن درخواست و صورتحساب دانا را غیرفعال نمی‌کند.
پارامترها و محدودیت‌ها
- model / input
- مدل دقیق کاتالوگ و متن یا آرایهٔ پیام‌های متنی؛ آرایهٔ محتوا از input_text و برای تاریخچهٔ assistant از output_text استفاده می‌کند.
- instructions
- دستور متنی اختیاری برای پاسخ.
- temperature / max_output_tokens
- پارامتر سازگار با مدل؛ سقف خروجی درگاه ۱۶٬۳۸۴ توکن و پیش‌فرض ۱٬۰۲۴ است.
- stream / store
- stream برای SSE؛ store فقط false.
import osfrom openai import OpenAI client = OpenAI( api_key=os.environ["DANA_API_KEY"], base_url="https://api.danaai.ai/v1", max_retries=0,) response = client.responses.create( model=os.environ["DANA_MODEL"], instructions="Answer briefly in Persian.", input="What is caching?", max_output_tokens=256, store=False,)print(response.output_text)پاسخ و خطاها
id، object=response، status=completed، model، output[] و usage. متن در output[].content[].text است و SDK آن را به output_text تبدیل می‌کند. ورودی یا پارامتر پشتیبانی‌نشده: 400.
- id / object
- شناسه پاسخ / response
- status
- completed یا incomplete در سقف توکن
- output[].content[].text
- متن عمومی پاسخ
- usage
- input_tokens، output_tokens، total_tokens
احراز هویت: Authorization: Bearer DANA_API_KEY. خطاهای مشترک: 401 کلید نامعتبر، 403 دسترسی ناکافی، 429 محدودیت درخواست. خطاهای ورودی و خروجی این عملیات را در پارامترها و یادداشت‌های بالا بررسی کنید.
نمونه‌ها از پکیج رسمی openai یا HTTP استاندارد استفاده می‌کنند، نه «SDK جدید دانا». کپی‌کردن کد هیچ درخواست پولی ارسال نمی‌کند. کلید را فقط در سرور نگه دارید.