راهنمای جامع استفاده از کلیدهای API هوشی برای دسترسی به مدل‌های پیشرفته هوش مصنوعی

در دنیای امروز، دسترسی به ابزارهای قدرتمند هوش مصنوعی برای توسعه‌دهندگان، پژوهشگران و کسب‌وکارها امری حیاتی است. پلتفرم هوشی (hooshi.net) با ارائه سرویس API خود، این امکان را فراهم کرده تا به طیف وسیعی از مدل‌های پیشرفته هوش مصنوعی دسترسی داشته باشید. این سرویس، که عملکردی مشابه با APIهای پیشرو در صنعت دارد، انعطاف‌پذیری بالایی را برای کاربران به ارمغان می‌آورد و امکان بهره‌مندی از مدل‌های متنوع را میسر می‌سازد.

با ایجاد یک حساب کاربری در هوشی، شما به دنیایی از امکانات بی‌پایان و دسترسی به خدمات برتر هوش مصنوعی دست خواهید یافت. تمامی این خدمات با تعرفه‌های شفاف و بدون هیچ‌گونه کارمزد پنهان ارائه می‌شوند.

مدیریت کلیدهای API در پلتفرم هوشی

برای شروع کار با APIهای هوش مصنوعی هوشی، مراحل زیر را دنبال کنید:

۱. ساخت کلید API جدید

پس از ورود به داشبورد هوشی، به بخش مدیریت کلیدهای API مراجعه کنید. با انتخاب گزینه «ایجاد کلید جدید»، می‌توانید کلید اختصاصی خود را برای دسترسی به تمامی سرویس‌های هوش مصنوعی هوشی ایجاد نمایید. ساخت توکن API در هوشی فرآیندی ساده و سریع است.

۲. تنظیمات امنیتی پیشرفته

برای افزایش امنیت کلیدهای API خود، هوشی امکانات ویژه‌ای را فراهم کرده است:

• محدودیت دسترسی بر اساس IP
• تعیین سطح دسترسی به مدل‌های خاص
• فعال یا غیرفعال نمودن کلید بدون نیاز به حذف آن
• پشتیبانی از پروتکل‌های امنیتی پیشرفته

۳. مدیریت هوشمند بودجه

هوشی کنترل کاملی بر هزینه‌های شما را تضمین می‌کند:

• تعیین سقف بودجه ماهانه
• تنظیم محدودیت کلی هزینه‌ها
• مانیتورینگ مصرف در لحظه از طریق صفحه صورتحساب

بیلینگ شفاف هوشی به شما این اطمینان را می‌دهد که هزینه‌هایتان کاملاً قابل پیش‌بینی و کنترل‌شده باشد.

۴. تنظیم دوره اعتبار کلید API

امکان تعیین محدودیت زمانی برای کلیدهای API وجود دارد:

• تنظیم دوره اعتبار دلخواه (مثلاً ۷ روزه)
• مدیریت چرخه حیات کلیدها
• قابلیت تمدید خودکار برای کلیدهای ضروری

نکته امنیتی: برای حفظ حداکثر امنیت، توصیه می‌شود کلیدهای API خود را به صورت دوره‌ای جایگزین نمایید.

استفاده از کلیدهای API هوشی

برای استفاده از این کلیدها، لازم است URL پایه در کتابخانه‌هایی مانند OpenAI را به آدرس هوشی تغییر دهید. با این تغییر ساده، امکان استفاده از سرویس‌های پیشرفته هوش مصنوعی با استفاده از API Keyهای هوشی فراهم می‌آید.

مثال استفاده در Langchain:

ابتدا از بروز بودن کتابخانه‌ها اطمینان حاصل کنید:

pip install -U openai
pip install -U langchain
pip install -U langchain_openai

دسترسی به مدل‌های گفتگو (Chat Completions):

from langchain_openai import ChatOpenAI  # pip install -U langchain_openai

messages = [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello world!"},
]

# استفاده از یک مدل پیشرفته
model_name = "gpt-4o-mini"

llm = ChatOpenAI(
    model=model_name, base_url="https://api.hooshi.net/v1", api_key="YOUR_HOOSHI_API_KEY"
)

llm.invoke(messages)

استفاده از مدل‌های چندوجهی (Multimodal) و ارسال تصویر:

from langchain_openai import ChatOpenAI # pip install -U langchain_openai
import base64
import os

base_url = "https://api.hooshi.net/v1"
api_key = "YOUR_HOOSHI_API_KEY"

model_name = "gpt-4o"

llm = ChatOpenAI(
    base_url=base_url,
    model=model_name,
    api_key=api_key,
)

IMAGE_PATH = "sample.png"

# Open the image file and encode it as a base64 string
def encode_image(image_path):
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode("utf-8")

base64_image = encode_image(IMAGE_PATH)
image_ext = os.path.splitext(IMAGE_PATH)[1][1:]

messages = [
    {
        "role": "system",
        "content": "You are a helpful assistant.",
    },
    {
        "role": "user",
        "content": [
            {
                "type": "text",
                "text": "Describe the image.",
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": f"data:image/{image_ext};base64,{base64_image}",
                    "detail": "auto",
                },
            },
        ],
    },
]

ai_message = llm.invoke(messages)
print(ai_message.content)

روش استفاده از متن به صدا (TTS) و صدا به متن (STT):

برای استفاده از قابلیت‌های تبدیل متن به گفتار و گفتار به متن، می‌توانید از کتابخانه رسمی OpenAI با تنظیم URL پایه به هوشی استفاده کنید.

from openai import OpenAI # pip install -U openai

client = OpenAI(
    base_url="https://api.hooshi.net/v1",
    api_key="YOUR_HOOSHI_API_KEY"
)

# Text to Speech Example
speech_file_path = "./speech.mp3"
resp
    model="tts-1",
    voice="alloy",
    input="Today is a wonderful day to build something people love!",
)
response.stream_to_file(speech_file_path)

# Speech to Text Example
audio_file = open("/path/to/your/audio.mp3", "rb")
transcription = client.audio.transcriptions.create(
    model="whisper-1", 
    file=audio_file, 
    response_format="text"
)
print(transcription.text)

تولید تصویر با مدل DALL-E 3:

from openai import OpenAI

client = OpenAI(base_url="https://api.hooshi.net/v1", api_key="YOUR_HOOSHI_API_KEY")

resp
    model="dall-e-3",
    prompt="a white siamese cat",
    size="1024x1024",
    quality="standard",
    n=1,
)

image_url = response.data[0].url
print(f"Generated image URL: {image_url}")

مثال استفاده در فریمورک .NET با کتابخانه Betalgo:

برای توسعه‌دهندگان دات‌نت، کتابخانه Betalgo امکان یکپارچه‌سازی آسان را فراهم می‌کند.

// Install-Package Betalgo.Ranul.OpenAI
using Betalgo.Ranul.OpenAI;
using Betalgo.Ranul.OpenAI.Models;
using System.Collections.Generic;
using System.Threading.Tasks;

public static async IAsyncEnumerable InvokeStreamAsync(string model = "gpt-3.5-turbo")
{
    string AvalAIApiKey = "YOUR_HOOSHI_API_KEY"; // کلید API هوشی خود را اینجا قرار دهید
    string BaseUrl = "https://api.hooshi.net/v1";
    var openAiService = new OpenAIService(new OpenAiOptions()
    {
        ApiKey = AvalAIApiKey,
        BaseDomain = BaseUrl
    });

    var completi ChatCompletionCreateRequest
    {
        Messages = new List
        {
            ChatMessage.FromSystem("You are a helpful assistant."),
            ChatMessage.FromUser("How to implement hooshi base url in betalgo .NET openai package?"),
        },
        Model = model,
        MaxTokens = 50 // optional
    });
    await foreach (var completion in completionResult)
    {
        yield return completion;
    }
}

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

چرا هوشی؟

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