Python SDK
با SDK رسمی OpenAI و کلید دانا، از برنامهٔ پایتون خود پاسخ متنی بگیرید. آدرس درخواستها به درگاه دانا تغییر میکند.
این راهنما برای متن است، نه اجرای Agent. ابزارها، previous_response_id و store: true در این درگاه پشتیبانی نمیشوند.
- ۰۱
نصب SDK رسمی
در محیط مجازی پروژه اجرا کنید. این دستور فقط کتابخانه را نصب میکند.
TerminalShell python -m pip install openai - ۰۲
کلید را به محیط اجرای سرور بدهید
DANA_API_KEY را از بخش کلیدهای همین کنسول بسازید و در secret manager یا متغیر محیطی محیط اجرا قرار دهید. مقدار زیر فقط جاینگهدار است؛ ذخیرهٔ فایل .env بهتنهایی آن را در Python بارگذاری نمیکند.
.env.example · بهصورت خودکار بارگذاری نمیشودEnvironment DANA_API_KEY=YOUR_DANA_API_KEYDANA_BASE_URL=https://api.danaai.ai/v1DANA_MODEL=MODEL_ID_FROM_CATALOG - ۰۳
اتصال و فهرست مدلها را بررسی کنید
پس از تنظیم متغیر محیطی، فایل را اجرا کنید. فقط مدلهای مجاز کلید شما برمیگردند؛ برای مرحلهٔ بعد مدل متنی آماده با supported_endpoints شامل /responses را انتخاب کنید. این مرحله تولید پولی نیست.
dana_check.pyPython import osfrom openai import OpenAI client = OpenAI( api_key=os.environ["DANA_API_KEY"], base_url=os.environ.get("DANA_BASE_URL", "https://api.danaai.ai/v1"), max_retries=0,) for model in client.models.list().data: print(model.id, model.model_extra) - ۰۴
اولین پاسخ متنی را دریافت کنید
دارای هزینهٔ تولیدشناسهٔ مدل را از مرحلهٔ قبل در DANA_MODEL بگذارید. اجرای این نمونه درخواست تولید میفرستد و مطابق قیمت مدل محاسبه میشود.
dana_text.pyPython import osfrom openai import OpenAI client = OpenAI( api_key=os.environ["DANA_API_KEY"], base_url=os.environ.get("DANA_BASE_URL", "https://api.danaai.ai/v1"), max_retries=0,) response = client.responses.create( model=os.environ.get("DANA_MODEL", "MODEL_ID_FROM_CATALOG"), input="Explain an API in two short sentences.", max_output_tokens=256, store=False,)print(response.output_text)
قرارداد و نمونهٔ مسیرهای سازگار را جداگانه بررسی کنید؛ قابلیتهای هر مدل در کاتالوگ مشخص است.