شروع سریع
کلید 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 را اضافه کنید و قطعهها را یکییکی بخوانید.
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 نگاه کنید، صبر کنید و دوباره بفرستید. |
فهرست کامل خطاها در صفحهٔ خطاها است.
گام بعدی
- احراز هویت: نگهداری کلید و کلید جدا برای هر برنامه.
- استریم پاسخ: خواندن قطعهها در مرورگر و سرور.
- مرجع نقطههای پایانی: همهٔ پارامترها و پاسخها.
این صفحه کمکتان نکرد؟ به ما بگویید.