داکیومنت وب‌سرویس Ai

aliw.subnitro.pro · API Portal

API آماده برای پاسخ‌های فارسی کوتاه و شیطون

سریع وصل شو، سؤال بده، پاسخ بگیر — بدون دردسر

این داکیومنت دقیقاً بر اساس مشخصات وب‌سرویس apiAi.php نوشته شده: پشتیبانی از GET و POST، مدیریت ۶ کلید، اعتبارسنجی پاسخ تا ۳ تلاش، و خروجی JSON با فیلدهای مشخص.

🧩 Usage روش ارسال درخواست
GET

ارسال با Query String

پیام را در پارامتر message می‌فرستی. مثالی:

https://aliw.subnitro.pro/Ai/apiAi.php?message=سلام%20خوبی؟
نکته: message حتماً باید URL-Encoded باشد.
POST

ارسال با JSON

بدنه‌ی درخواست را JSON بفرست:

{
  "message": "متن پیام",
  "temperature": 0.7,
  "max_tokens": 60
}
temperature بین 0 تا 2 است. max_tokens پیش‌فرض 60 دارد.
POST

ارسال با Form-data

بدنه به شکل فرم ارسال می‌شود:

message=متن%20پیام
temperature=0.7
max_tokens=60
⚙️ رفتار سرویس

قوانین و لایه‌های هوشمند

این سرویس برای پاسخ فارسیِ کوتاه و قابل استفاده طراحی شده: مدیریت ۶ کلید، failover خودکار، اعتبارسنجی پاسخ تا ۳ تلاش و محدودیت طول ورودی.

محدودیت طول پیام ورودی: حداکثر ۲۰۰۰ کاراکتر
طول پاسخ: حداکثر ۱۵ کلمه
🎛️ Parameters پارامترهای ورودی

پارامترها

همه چیز که باید برای درخواست ارسال کنی:

Key نوع وضعیت توضیح
message string اجباری متن سوال یا شروع مکالمه
temperature float اختیاری بین 0 تا 2 · پیش‌فرض: 0.7
max_tokens int اختیاری حداکثر توکن خروجی · پیش‌فرض: 60
اگر از GET استفاده می‌کنی، می‌توانی message را در query بفرستی. برای temperature و max_tokens هم در صورت نیاز ارسال کن (در POST راحت‌تر است).
📤 Response نمونه پاسخ JSON

نمونه پاسخ

ساختار خروجی این سرویس:

{
  "success": true,
  "text": "واویلا، خوبم بابا! اهواز چه هوایی داره امروز؟ 🔥",
  "model": "openai/gpt-oss-20b:free",
  "key_used": 1,
  "attempt": 1
}

توضیح فیلدها

پاسخ شامل وضعیت، متن کوتاه خروجی و متادیتاست:

Field نوع معنی
success boolean وضعیت درخواست (true/false)
text string متن پاسخ (حداکثر ۱۵ کلمه)
model string مدل استفاده‌شده
key_used number شماره کلید API استفاده‌شده
attempt number تعداد تلاش برای دریافت پاسخ معتبر
اگر موفق نبود، بهتر است error handling را انجام بدهی. (ساختار خطا می‌تواند بسته به پیاده‌سازی تغییر کند.)
💻 Examples نمونه کدها (چند زبان)
PHP · GET
<?php
$response = file_get_contents(
  'https://aliw.subnitro.pro/Ai/apiAi.php?message=' .
  urlencode('سلام خوبی؟')
);
$data = json_decode($response, true);
echo $data['text'];
?>
cURL · GET
curl -X GET "https://aliw.subnitro.pro/Ai/apiAi.php?message=سلام%20خوبی؟"
JavaScript · fetch
const url =
  'https://aliw.subnitro.pro/Ai/apiAi.php?message=' +
  encodeURIComponent('سلام خوبی؟');

const res = await fetch(url);
const data = await res.json();
console.log(data.text);
Python · requests
import requests

response = requests.get(
  "https://aliw.subnitro.pro/Ai/apiAi.php",
  params={"message": "سلام خوبی؟"}
)
data = response.json()
print(data["text"])
Node.js · axios
const axios = require("axios");

axios
  .get("https://aliw.subnitro.pro/Ai/apiAi.php", {
    params: { message: "سلام خوبی؟" }
  })
  .then((res) => console.log(res.data.text))
  .catch(console.error);
Go · net/http
package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
)

func main() {
  base := "https://aliw.subnitro.pro/Ai/apiAi.php"
  msg := url.QueryEscape("سلام خوبی؟")

  resp, _ := http.Get(base + "?message=" + msg)
  body, _ := io.ReadAll(resp.Body)

  fmt.Println(string(body))
}
C# · HttpClient
using var client = new HttpClient();

var url =
  "https://aliw.subnitro.pro/Ai/apiAi.php?message=" +
  Uri.EscapeDataString("سلام خوبی؟");

var response = await client.GetStringAsync(url);
Console.WriteLine(response);
Swift · URLSession
import Foundation

let url = URL(string:
  "https://aliw.subnitro.pro/Ai/apiAi.php?message=سلام%20خوبی؟"
)!

let task = URLSession.shared.dataTask(with: url) {
  data, _, _ in
  if let data = data,
     let json = try? JSONSerialization.jsonObject(
       with: data
     ) {
    print(json)
  }
}
task.resume()
⚡ Try it now تست سریع داخل صفحه

یک پیام بفرست

همین‌جا تست کن. این دمو با GET درخواست می‌زند. اگر خواستی، بعداً می‌توانیم نسخه POST هم بهش اضافه کنیم.

محدودیت: ۲۰۰۰ کاراکتر · خروجی: حداکثر ۱۵ کلمه

نتیجه (JSON)

{"status":"idle"}
اگر با خطا مواجه شدی، ممکن است پارامترها یا شبکه مشکل داشته باشد.
🧠 Personality شخصیت ربات

مشخصات کلی

سبک پاسخ‌ها: کوتاه، شیطون، صمیمی، با لحن جنوبی و ایموجی.

ویژگی مقدار
نام هرگز فاش نمی‌شود
سن ۲۴ سال
شهر اهواز، خوزستان
لحن شیطون · خون‌کرم · صمیمی
عبارات بابا · واویلا · آخ جون

ویژگی‌های کلیدی سرویس

این بخش برای اینکه دقیق بفهمی سرویس چطور خروجی می‌سازد:

- مدیریت ۶ کلید + failover خودکار
- اعتبارسنجی پاسخ تا ۳ بار تلاش مجدد
- مدل ثابت: openai/gpt-oss-20b:free
- پاسخ‌های کوتاه: حداکثر ۱۵ کلمه
- محدودیت طول ورودی: ۲۰۰۰ کاراکتر
- CORS فقط برای دامنه‌های مجاز (config.json)
🛡️ Security نکات امنیتی و محدودیت‌ها

محدودیت‌های کلیدی

- message حتماً باید ارسال شود (اجباری)
- طول message تا ۲۰۰۰ کاراکتر
- دقت خروجی با تلاش مجدد تضمین می‌شود
- مدل ثابت برای ثبات رفتار

CORS و دامنه‌ها

سرویس طوری طراحی شده که درخواست از دامنه‌های مجاز پشتیبانی شود. اگر در مرورگر خطای CORS گرفتی، باید دامنه‌ات در config.json اضافه شود.