رفتن به محتوای اصلی
کنسول / مستندات API
BUILD WITH DANA

ابزار شما. راه اتصال روشن.

از اولین درخواست تا انتخاب ابزار؛ با نمونه‌کد و وضعیت سازگاری واقعی.

مرجع API
۸ راهنما

یک آدرس مشترک، به معنی پشتیبانی از همهٔ قابلیت‌های هر ابزار نیست. راهنماهای SDK برای متن آماده‌اند؛ اتصال کامل ایجنت‌ها فعلاً پشتیبانی نمی‌شود.

راهنمای قدم‌به‌قدم

Python SDK

پاسخ متنی آماده

با SDK رسمی OpenAI و کلید دانا، از برنامهٔ پایتون خود پاسخ متنی بگیرید. آدرس درخواست‌ها به درگاه دانا تغییر می‌کند.

محدودهٔ این راهنما

این راهنما برای متن است، نه اجرای Agent. ابزارها، previous_response_id و store: true در این درگاه پشتیبانی نمی‌شوند.

  1. ۰۱

    نصب SDK رسمی

    در محیط مجازی پروژه اجرا کنید. این دستور فقط کتابخانه را نصب می‌کند.

    TerminalShell
    python -m pip install openai
  2. ۰۲

    کلید را به محیط اجرای سرور بدهید

    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
  3. ۰۳

    اتصال و فهرست مدل‌ها را بررسی کنید

    پس از تنظیم متغیر محیطی، فایل را اجرا کنید. فقط مدل‌های مجاز کلید شما برمی‌گردند؛ برای مرحلهٔ بعد مدل متنی آماده با 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)
  4. ۰۴

    اولین پاسخ متنی را دریافت کنید

    دارای هزینهٔ تولید

    شناسهٔ مدل را از مرحلهٔ قبل در 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)
پاسخ زنده، فایل یا تولید چندرسانه‌ای می‌خواهید؟

قرارداد و نمونهٔ مسیرهای سازگار را جداگانه بررسی کنید؛ قابلیت‌های هر مدل در کاتالوگ مشخص است.

مسیرهای API
DANA DEVELOPER PLATFORMیک اتصال؛ مدل‌های متنوع