هویدای

شروع سریع

کلید API بسازید، SDK را تنظیم کنید و اولین درخواست را بفرستید.

زمان مطالعه: ۱ دقیقه

ساخت کلید API

وارد پنل شوید، از بخش «کلیدها» گزینهٔ «ساخت کلید» را بزنید و برای کلید نامی بگذارید، مثلاً «اسکریپت گزارش». کلید فقط یک بار کامل نشان داده می‌شود؛ همان لحظه آن را در جای امنی ذخیره کنید. کلیدها با hvd_ شروع می‌شوند.

کلید را در کد نگذارید

آن را در متغیر محیطی HOVEYDAI_API_KEY نگه دارید. اگر کلیدی لو رفت، از پنل حذفش کنید و کلید تازه بسازید.

نصب کتابخانه

نیازی به کتابخانهٔ جداگانه نیست. همان کتابخانهٔ رسمی OpenAI کار می‌کند.

pip install openai

اولین درخواست

تنها دو چیز نسبت به کد معمول فرق می‌کند: نشانی پایه و کلید. بقیهٔ کد همان است که از پیش می‌شناسید.

import osfrom openai import OpenAI client = OpenAI(    base_url="https://<HOVEYDAI_BASE_URL>/v1",    api_key=os.environ["HOVEYDAI_API_KEY"],) resp = client.chat.completions.create(    model="MODEL_ID",    messages=[{"role": "user", "content": "Hello! Introduce yourself in one sentence."}],)print(resp.choices[0].message.content)

به‌جای MODEL_ID شناسهٔ یکی از مدل‌ها را بگذارید؛ فهرست آن در مدل‌ها و مدل‌ها و قیمت است. اگر پاسخی در خروجی دیدید، همه‌چیز درست است.

نشانی پایه

در این نمونه‌ها <HOVEYDAI_BASE_URL> جای‌نگهدار است و با نشانی واقعی جایگزین می‌شود.

استریم پاسخ

برای نمایش پاسخ هم‌زمان با تولید، stream=True را اضافه کنید و قطعه‌ها را یکی‌یکی بخوانید.

Python
stream = client.chat.completions.create(    model="MODEL_ID",    messages=[{"role": "user", "content": "Write a two-line poem."}],    stream=True,)for chunk in stream:    print(chunk.choices[0].delta.content or "", end="")

اگر خطا گرفتید

سه خطای رایج در همان تماس اول:

وضعیتیعنیکار بعدی
401کلید نادرست است یا نفرستاده‌اید.مقدار api_key را با کلید پنل مقایسه کنید.
404شناسهٔ مدل را نمی‌شناسیم.شناسه را از فهرست مدل‌ها کپی کنید.
429در مدت کوتاه درخواست زیادی فرستاده‌اید.به Retry-After نگاه کنید، صبر کنید و دوباره بفرستید.

فهرست کامل خطاها در صفحهٔ خطاها است.

گام بعدی

این صفحه کمکتان نکرد؟ به ما بگویید.