docs: update ai

Author: A-Najmabadi

public/llms/ai/google-gemini.md

@@ -11,13 +11,15 @@
 
 پس از [ایجاد سرویس هوش مصنوعی](https://docs.liara.ir/ai/quick-start) و دریافت `baseUrl` و [ساخت کلید](https://docs.liara.ir/ai/details/keys/#create)، می‌توانید از مدل‌های Gemini استفاده کنید.
 
-> در قطعه کدهای ارائه‌شده توسط لیارا برای اتصال به مدل، از OpenAI SDK استفاده می‌شود. تمامی مدل‌هایی که لیارا ارائه می‌دهد؛ سازگار با OpenAI SDK هستند.
+> در قطعه کدهای ارائه‌شده توسط لیارا برای اتصال به مدل، از OpenAI SDK استفاده می‌شود. تمامی مدل‌هایی که لیارا ارائه می‌دهد؛ سازگار با OpenAI SDK هستند.  
+> همچنین بخوانید: [مستندات کار با Embedding Modelها](https://docs.liara.ir/ai/ai-sdk-core/embeddings)  
+> همچنین بخوانید: [مستندات تولید تصویر با هوش مصنوعی](https://docs.liara.ir/ai/foundations/image-generation/)
 
 ## اتصال به مدل
 
-برای اتصال به مدل در سطح کد، می‌توانید از دو ابزار استفاده کنید: 
+برای اتصال به مدل در سطح کد، می‌توانید از دو ابزار استفاده کنید:
 
-- `OpenAI SDK`: ابزار رسمی ارائه‌شده توسط [OpenAI](https://openai.com/). تمامی مدل‌های ارائه‌شده در لیارا، با این SDK سازگار هستند.
+- `OpenAI SDK`: ابزار رسمی ارائه‌شده توسط [OpenAI](https://openai.com/). تمامی مدل‌های ارائه‌شده در لیارا، با این SDK سازگار هستند.  
 - `AI SDK`: ابزار ارائه‌شده توسط [Vercel](https://ai-sdk.dev/). این SDK، تنها برای جاوااسکریپت و تایپ‌اسکریپت در دسترس است.
 
 در ادامه، نحوه اتصال به مدل، هم با `OpenAI SDK` و هم با `AI SDK`، بررسی شده است.
@@ -100,7 +102,6 @@ $result = $client->chat()->create([
 
 // Print the response
 echo $result->choices[0]->message->content;
-
 ```
 
 ### Python
@@ -134,7 +135,7 @@ completion = client.chat.completions.create(
 print(completion.choices[0].message.content)
 ```
 
-### .NET
+### NET.
 
 در ابتدا، برای استفاده از مدل هوش مصنوعی مدنظر خود در dotNET (CSharp)، باید پکیج مورد نیاز را با اجرای دستور زیر، نصب کنید:
 
@@ -261,32 +262,32 @@ const { text } = await generateText({
 console.log('Generated Text:', text);
 ```
 
-در قطعه کد‌های فوق، به‌جای `<baseUrl>`, آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`, کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`, نام یکی از مدل‌های فوق را قرار دهید.
+در قطعه کد‌های فوق، به‌جای `<baseUrl>`، آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`، کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`، نام یکی از مدل‌های فوق را قرار دهید.
 
 ## پارامترهای قابل تنظیم
 
-## OpenAI SDK
+### OpenAI SDK
 
 در OpenAI SDK، شما می‌توانید پارامترهای زیر را تنظیم کنید.
 
 > در نظر داشته باشید که پارامترهای زیر، ممکن است در برخی از مدل‌ها، پشتیبانی نشوند.
 
-- `frequency_penalty`:  عددی بین `-2` تا `2`. کاهش یا افزایش احتمال تکرار کلمات پرتکرار در پاسخ. هرچه بالاتر باشد؛ تنوع بیشتر است
-- `logit_bias`:  تغییر احتمال ظاهر شدن توکن‌های خاص
-- `n`: تعداد پاسخ‌هایی که قرار است مدل همزمان تولید کند.
-- `response_format`: مدل را مجبور می‌کند خروجی را به فرمت خاصی برگرداند
-- `seed`: مقدار عددی ثابت برای شروع تولید تصادفی، در صورت نیاز، به خروجی‌های قابل تکرار
-- `stop`: آرایه‌ای از رشته‌ها برای اینکه مدل هنگام رسیدن به آن‌ها پاسخ را متوقف کند
-- `stream`: اگر `true` باشد، پاسخ مدل به صورت استریم ارسال می‌شود. برای پیاده‌سازی‌های real-time یا رابط کاربری، این حالت مفید است
-- `stream_options`: تنظیمات مربوط به حالت `stream`. فقط وقتی استفاده می‌شود که `stream: true` باشد
-- `temperature`: عددی بین `0` تا `2`. کنترل میزان تصادفی بودن خروجی؛ عدد کمتر، واقع‌گرایی بیشتر و عدد بیشتر، خلاقیت بیشتر
-- `tool_choice`: تعیین کردن اینکه مدل چه زمانی Tool را فراخوانی کند (به‌صورت هوشمند یا همیشه)
-- `tools`: مشخص کردن یک‌سری Tool که مدل در صورت نیاز، آن‌ها را فراخوانی کند
+- `frequency_penalty`:  عددی بین `-2` تا `2`. کاهش یا افزایش احتمال تکرار کلمات پرتکرار در پاسخ. هرچه بالاتر باشد؛ تنوع بیشتر است  
+- `logit_bias`:  تغییر احتمال ظاهر شدن توکن‌های خاص  
+- `n`: تعداد پاسخ‌هایی که قرار است مدل همزمان تولید کند.  
+- `response_format`: مدل را مجبور می‌کند خروجی را به فرمت خاصی برگرداند  
+- `seed`: مقدار عددی ثابت برای شروع تولید تصادفی، در صورت نیاز، به خروجی‌های قابل تکرار  
+- `stop`: آرایه‌ای از رشته‌ها برای اینکه مدل هنگام رسیدن به آن‌ها پاسخ را متوقف کند  
+- `stream`: اگر `true` باشد، پاسخ مدل به صورت استریم ارسال می‌شود. برای پیاده‌سازی‌های real-time یا رابط کاربری، این حالت مفید است  
+- `stream_options`: تنظیمات مربوط به حالت `stream`. فقط وقتی استفاده می‌شود که `stream: true` باشد  
+- `temperature`: عددی بین `0` تا `2`. کنترل میزان تصادفی بودن خروجی؛ عدد کمتر، واقع‌گرایی بیشتر و عدد بیشتر، خلاقیت بیشتر  
+- `tool_choice`: تعیین کردن اینکه مدل چه زمانی Tool را فراخوانی کند (به‌صورت هوشمند یا همیشه)  
+- `tools`: مشخص کردن یک‌سری Tool که مدل در صورت نیاز، آن‌ها را فراخوانی کند  
 - `user`: شناسه‌ی کاربر نهایی. برای دسته‌بندی بهتر درخواست‌ها و جلوگیری از سوءاستفاده، به‌کار می‌رود
 
 در ادامه، مثال استفاده از این پارامترها، در زبان‌های مختلف، قرار گرفته است:
 
-### Python
+#### Python
 
 ```bash
 from openai import OpenAI
@@ -335,7 +336,7 @@ response = client.chat.completions.create(
 print(response)
 ```
 
-در قطعه کد‌ فوق، به‌جای `<baseUrl>`, آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`, کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`, نام یکی از مدل‌های فوق را قرار دهید.
+در قطعه کد‌ فوق، به‌جای `<baseUrl>`، آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`، کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`، نام یکی از مدل‌های فوق را قرار دهید.
 
 ## all links
 

public/llms/ai/openai.md

@@ -11,11 +11,12 @@
 
 پس از [ایجاد سرویس هوش مصنوعی](https://docs.liara.ir/ai/quick-start) و دریافت `baseUrl` و [ساخت کلید](https://docs.liara.ir/ai/details/keys/#create)، می‌توانید مانند دستورات و قطعه‌های کد زیر، از مدل‌های OpenAI استفاده کنید.
 
-> همچنین بخوانید: [مستندات کار با Embedding Modelها](https://docs.liara.ir/ai/ai-sdk-core/embeddings)
+> همچنین بخوانید: [مستندات کار با Embedding Modelها](https://docs.liara.ir/ai/ai-sdk-core/embeddings)  
+> همچنین بخوانید: [مستندات تولید تصویر با هوش مصنوعی](https://docs.liara.ir/ai/foundations/image-generation/)
 
 ## اتصال به مدل
 
-برای اتصال به مدل در سطح کد، می‌توانید از دو ابزار استفاده کنید:  
+برای اتصال به مدل در سطح کد، می‌توانید از دو ابزار استفاده کنید:
 
 - `OpenAI SDK`: ابزار رسمی ارائه‌شده توسط [OpenAI](https://openai.com/). تمامی مدل‌های ارائه‌شده در لیارا، با این SDK سازگار هستند.
 - `AI SDK`: ابزار ارائه‌شده توسط [Vercel](https://ai-sdk.dev/). این SDK، تنها برای جاوااسکریپت و تایپ‌اسکریپت در دسترس است.
@@ -100,7 +101,6 @@ $result = $client->chat()->create([
 
 // Print the response
 echo $result->choices[0]->message->content;
-
 ```
 
 ### Python
@@ -219,9 +219,9 @@ func main() {
 ### cURL
 
 ```bash
-curl <baseUrl>\chat\completions \\
-  -H "Content-Type: application/json" \\
-  -H "Authorization: Bearer <LIARA_API_KEY>" \\
+curl <baseUrl>\chat\completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <LIARA_API_KEY>" \
   -d '{
   "model": "<model_name>",
   "messages": [
@@ -259,12 +259,15 @@ const { text } = await generateText({
 });
 
 console.log('Generated Text:', text);
+
 ```
 
-در قطعه کد‌های فوق، به‌جای `<baseUrl>`، آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`, کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`, نام یکی از مدل‌های فوق را قرار دهید.
+در قطعه کد‌های فوق، به‌جای `<baseUrl>`، آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`، کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`، نام یکی از مدل‌های فوق را قرار دهید.
 
 ## پارامترهای قابل تنظیم
 
+### OpenAI SDK
+
 در OpenAI SDK، شما می‌توانید پارامترهای زیر را تنظیم کنید.
 
 > در نظر داشته باشید که پارامترهای زیر، ممکن است در برخی از مدل‌ها، پشتیبانی نشوند.
@@ -333,7 +336,7 @@ response = client.chat.completions.create(
 print(response)
 ```
 
-در قطعه کد‌ فوق، به‌جای `<baseUrl>`, آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`, کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`, نام یکی از مدل‌های فوق را قرار دهید.
+در قطعه کد‌ فوق، به‌جای `<baseUrl>`، آدرس سرویس هوش مصنوعی خود را قرار دهید و به‌جای `<LIARA_API_TOKEN>`، کلید API خود را وارد کنید. همچنین، به‌جای `<model_name>`، نام یکی از مدل‌های فوق را قرار دهید.
 
 ## all links
 

src/pages/ai/google-gemini.mdx

@@ -64,6 +64,16 @@ import Head from "next/head";
 در قطعه کدهای ارائه‌شده توسط لیارا برای اتصال به مدل، از OpenAI SDK استفاده می‌شود. تمامی مدل‌هایی که لیارا ارائه می‌دهد؛ سازگار با OpenAI SDK هستند.
 </p>
 </Alert>
+<Alert variant="info">
+  <p>
+    همچنین بخوانید: <Link href="/ai/ai-sdk-core/embeddings" className="text-[#2196f3] " >مستندات کار با Embedding Modelها</Link>
+  </p>
+</Alert>
+<Alert variant="info">
+  <p>
+    همچنین بخوانید: <Link href="/ai/foundations/image-generation/" className="text-[#2196f3] " >مستندات تولید تصویر با هوش مصنوعی</Link>
+  </p>
+</Alert>
 
 
 

src/pages/ai/openai.mdx

@@ -66,6 +66,11 @@ import Head from "next/head";
     همچنین بخوانید: <Link href="/ai/ai-sdk-core/embeddings" className="text-[#2196f3] " >مستندات کار با Embedding Modelها</Link>
   </p>
 </Alert>
+<Alert variant="info">
+  <p>
+    همچنین بخوانید: <Link href="/ai/foundations/image-generation/" className="text-[#2196f3] " >مستندات تولید تصویر با هوش مصنوعی</Link>
+  </p>
+</Alert>
 
 <Section id="connect" title="اتصال به مدل" />