اولین درخواست API پیکو را با پایتون اجرا کنید

اگر برای اولین بار یک اپ را به پیکو وصل می‌کنید، از یک سؤال کوتاه و یک پاسخ کوتاه شروع کنید. این کار تشخیص خطاهای اتصال، اعتبار و انتخاب مدل را ساده‌تر می‌کند.

شناسهٔ مدل و کلید را جداگانه آماده کنید

فهرست فعلی مدل‌ها را با درخواست GET https://api.picoai.ir/v1/models ببینید و مقدار id را بردارید. کاتالوگ مدل‌های شناخته‌شدهٔ غیرفعال را هم نشان می‌دهد. برای فراخوانی، شناسه‌ای را انتخاب کنید که در فهرست API وجود دارد. کلید را از داشبورد کلیدها بسازید و در متغیر محیطی PICO_API_KEY قرار دهید. شناسهٔ انتخابی را هم به PICO_MODEL بدهید.

از سمت سرور درخواست بفرستید

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.picoai.ir/v1",
    api_key=os.environ["PICO_API_KEY"],
    timeout=30,
    max_retries=0,
)

result = client.chat.completions.create(
    model=os.environ["PICO_MODEL"],
    messages=[{"role": "user", "content": "در یک جمله تفاوت تومان و ریال را توضیح بده."}],
    max_tokens=120,
)
print(result.choices[0].message.content)
if result.usage:
    print("input:", result.usage.prompt_tokens, "output:", result.usage.completion_tokens)

با تنظیم max_retries=0 در اولین آزمایش، همان خطای اولیه را می‌بینید. اگر پاسخ 401 بود، اعتبار کلید را بررسی کنید. برای 402 سراغ موجودی کیف پول و سقف خروجی بروید. اگر 404 گرفتید، نام مدل و مسیر را با فهرست رسمی تطبیق دهید.

نتیجه را در داشبورد پیدا کنید

بعد از پاسخ، زمان اجرا و توکن‌ها را با مصرف حساب تطبیق دهید. همین آزمایش را با دو ورودی واقعی و کوتاه تکرار کنید تا پیش از وصل کردن برنامه، هم کیفیت پاسخ و هم هزینهٔ معمول دستتان بیاید. برای جزئیات بدنه و روش احراز هویت، را ببینید.