پلتفرم AvalAI با ارائه سرویس جدید استفاده از API مدلهای هوش مصنوعی برتر، فرصتی استثنایی را برای توسعهدهندگان، محققان و کسبوکارها فراهم آورده است تا به مجموعهای وسیع از خدمات پیشرفته هوش مصنوعی دسترسی پیدا کنند. این سرویس، که عملکردی مشابه با سرویسهای API شرکت OpenAI دارد، انعطافپذیری بینظیری را به کاربران ارائه میدهد و به زودی قرار است خدمات دیگر ارائهدهندگان برجستهای مانند Google و Anthropic را نیز در بر بگیرد.
با ایجاد تنها یک حساب توسعهدهنده در AvalAI، شما به دنیایی از امکانات بیپایان و دسترسی نامحدود به تمامی خدمات برتر هوش مصنوعی دست خواهید یافت، و این همه مطابق با تعرفههای رسمی ارائهدهندگان و بدون هیچ گونه کارمزد اضافی.
ایجاد و مدیریت کلیدهای API
پس از ورود به پیشخوان پلتفرم AvalAI، به بخش کلیدها API مراجعه کنید و با کلیک بر روی دکمه “ایجاد کلید جدید”، کلید جدیدی بسازید. این کلیدها به شما امکان دسترسی به APIهای AvalAI را میدهند و میتوانید آنها را در بستههای برنامهنویسی مختلف به کار ببرید.
استفاده از کلیدهای API
برای استفاده از این کلیدها، لازم است URL پایه در کتابخانههای OpenAI را به آدرس جدید https://api.avalai.ir/v1
تغییر دهید. درصورتی که سرورهای شما داخل کشور قرار گرفتهاند و میخواهید فارغ از اختلالات اینترنت از پایداری ارتباط مطمعن شوید میتوانید از آدرس https://api.avalapis.ir/v1
استفاده کنید. (دسترسی به https://api.avalapis.ir/v1 فقط از داخل کشور امکان پذیر است اما آدرس اصلی https://api.avalai.ir/v1 محدودیت جغرافیایی ندارد).
با این تغییر ساده، امکان استفاده از سرویسهای OpenAI را با استفاده از API Keyهای AvalAI فراهم میآورد.
روش استفاده از کلیدهای API پلتفرم AvalAI در کتابخانه 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
llm = ChatOpenAI(model="gpt-4o-mini", base_url="https://api.avalai.ir/v1", api_key="aa-***********")
llm.invoke("hello")
استفاده از GPT-4o و ارسال تصویر
from langchain_openai import ChatOpenAI # pip install -U langchain_openai
import base64
import os
base_url = "https://api.avalai.ir/v1"
api_key = "AVALAI_API_KEY"
model_name = "gpt-4o"
llm = ChatOpenAI(
base_url=base_url,
model=model_name,
api_key=api_key,
)
IMAGE_PATH = "sample.jpg"
# 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 – Text to Speech) در کتابخانه رسمی OpenAI
از بروز بودن کتابخانه مطمعن شوید: pip install -U openai
from openai import OpenAI # pip install -U openai
client = OpenAI(
base_url="https://api.avalai.ir/v1",
api_key="AVALAI_API_KEY"
)
speech_file_path = "./speech.mp3"
response = client.audio.speech.create(
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) در کتابخانه رسمی OpenAI
از بروز بودن کتابخانه مطمعن شوید: pip install -U openai
from openai import OpenAI # pip install -U openai
client = OpenAI(
base_url="https://api.avalai.ir/v1",
api_key="AVALAI_API_KEY"
)
audio_file = open("/path/to/file/speech.mp3", "rb")
transcription = client.audio.transcriptions.create(
model="whisper-1",
file=audio_file,
response_format="text"
)
print(transcription.text)
تولید تصویر با مدل DALL-E 3 در کتابخانه OpenAI
from openai import OpenAI
client = OpenAI(base_url="https://api.avalai.ir/v1", api_key="AVALAI_API_KEY")
response = client.images.generate(
model="dall-e-3",
prompt="a white siamese cat",
size="1024x1024",
quality="standard",
n=1,
)
image_url = response.data[0].url
روش استفاده از کلیدهای API پلتفرم AvalAI در فریمورک .NET (دات نت)
کتابخانه betalgo
public static async IAsyncEnumerable InvokeStreamAsync(string model = "gpt-3.5-turbo")
{
static string AvalAIApiKey = "Your api key";
static string BaseUrl = "https://api.avalai.ir/v1";
var openAiService = new OpenAIService(new OpenAiOptions()
{
ApiKey = AvalAIApiKey,
BaseDomain = BaseUrl
});
var completionResult = openAiService.ChatCompletion.CreateCompletionAsStream(new ChatCompletionCreateRequest
{
Messages = new List
{
ChatMessage.FromSystem("You are a helpful assistant."),
ChatMessage.FromUser("How to implement avalai base url in betalgo .NET openai package?"),
ChatMessage.FromAssistant("You can read about it in https://avalai.ir/blog/how-to-use-avalai-api-keys ."),
},
Model = model,
MaxTokens = 50//optional
});
await foreach (var completion in completionResult)
{
if (completion.Successful)
{
yield return completion.Choices.FirstOrDefault()?.Message.Content;
}
else
{
if (completion.Error == null)
{
throw new Exception("Unknown Error");
}
Debug.WriteLine($"{completion.Error.Code}: {completion.Error.Message}");
}
}
}
روش استفاده از کلیدهای API پلتفرم AvalAI در TypeScript / JavaScript (جاوا اسکریپت / تایپ اسکریپت)
import OpenAI from "openai";
const baseURL = "https://api.avalai.ir/v1";
const openai = new OpenAI({
apiKey: process.env.AVALAI_API_KEY,
baseURL: baseURL
});
const chatCompletion = await openai.chat.completions.create({
messages: [{ role: "user", content: "Say hi" }],
model: "gpt-3.5-turbo",
});
روش استفاده از کلیدهای API پلتفرم AvalAI در PHP
کتابخانه: openai-php
// composer require openai-php/client
// composer require guzzlehttp/guzzle
$yourApiKey = getenv('AVALAI_API_KEY');
$client = OpenAI::factory()
->withApiKey($yourApiKey)
->withBaseUri('api.avalai.ir/v1')
->withStreamHandler(fn (RequestInterface $request): ResponseInterface => $client->send($request, [
'stream' => true
]))
->make();
$result = $client->chat()->create([
'model' => 'gpt-3.5-turbo',
'messages' => [
['role' => 'user', 'content' => 'Hello!'],
],
]);
echo $result->choices[0]->message->content;
دسترسی آسان و راحت، بدون نیاز به مواجهه با محدودیتهای جغرافیایی، پرداخت امن ریالی بدون کارمزد اضافی، فعال سازی آنی حساب کاربری و پایداری حداکثری زیرساختهای AvalAI، همه و همه تضمینکننده یک تجربه دلچسب برای توسعهدهندگان، محققان و کسبوکارهاست. با پلتفرم هوش مصنوعی AvalAI، شما به راحتی میتوانید از ظرفیت برترین مدلهای هوش مصنوعی برای رشد و توسعه پروژهها و ایدههای خود بهرهمند شوید.
مزایای استفاده از API پلتفرم AvalAI
شفافیت و مقرون به صرفه بودن قیمتگذاری
پلتفرم AvalAI بدون اعمال کارمزد اضافی، تعرفههای رسمی ارائهدهندگان را به شما ارائه میدهد تا از شفافیت کامل در هزینهها اطمینان حاصل کنید.
سهولت و کاربری بیدغدغه
AvalAI با حذف موانع فنی، استفاده از API را برای کاربران در هر سطحی از دانش هوش مصنوعی ساده و در دسترس ساخته است.
امنیت و سهولت پرداخت
پلتفرم هوش مصنوعی AvalAI با پشتیبانی از درگاههای پرداخت امن ایرانی، تراکنشهای شما را با آسودگی خاطر و بدون هیچگونه نگرانی به انجام میرساند.
فعالسازی فوری حساب کاربری
پس از ثبتنام، میتوانید بدون فوت وقت از خدمات AvalAI بهرهمند شوید و فرآیند خود را آغاز کنید.
پایداری زیرساختها
AvalAI با اتکا به زیرساختهای قدرتمند، ثبات و پایداری خدمات خود را در بالاترین سطح تضمین میکند.