راهنمای استفاده

CAS – سرویس تولید تصویر هوش مصنوعی

با تشکر از انتخاب و استفاده از سرویس CAS. این سرویس به شما امکان می‌دهد با ارسال پرامپت متنی، تصاویر با کیفیت بالا و سبک‌های مختلف تولید کنید.

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

نصب و راه‌اندازی

برای استفاده از سرویس CAS، مراحل زیر را دنبال کنید:

دریافت کلید API

برای استفاده از API، ابتدا باید در سایت CAS ثبت‌نام کرده و یک کلید API دریافت کنید.

نیازمندی‌های سیستم

• PHP 7.4+ / Node.js 18+ / Python 3.10+
• دسترسی به اینترنت برای ارسال درخواست‌ها
• کتابخانه‌های HTTP مناسب (cURL، fetch، requests)

نصب کتابخانه‌ها (در صورت نیاز)

Python:

pip install requests

Node.js:

npm install node-fetch

استفاده از API

آدرس Endpoint

POST https://api.aishahab.ir/v2/image/completions.php

هدرها

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

پارامترهای ورودی

نمونه درخواست و پاسخ

Python:

import requests
import json

url = "https://api.aishahab.ir/v2/image/completions.php"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "prompt": "یک پسر انیمه‌ای با چشم‌های آبی",
    "steps": 5,
    "width": 512,
    "height": 512,
    "style": "anime"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

# نمایش لینک تصویر خروجی
print(result["image_url"])

PHP:

 "یک پسر انیمه‌ای با چشم‌های آبی",
    "steps" => 5,
    "width" => 512,
    "height" => 512,
    "style" => "anime"
];
$options = [
    'http' => [
        'header'  => "Content-Type: application/json\r\nAuthorization: Bearer YOUR_API_KEY\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    ]
];
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);
echo $response["image_url"];
?>

JavaScript (Node.js):

import fetch from "node-fetch";

const url = "https://api.aishahab.ir/v2/image/completions.php";
const data = {
    prompt: "یک پسر انیمه‌ای با چشم‌های آبی",
    steps: 5,
    width: 512,
    height: 512,
    style: "anime"
};

const response = await fetch(url, {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    body: JSON.stringify(data)
});

const result = await response.json();
console.log(result.image_url);

پاسخ نمونه

{
  "success": true,
  "image_url": "https://cdn.aishahab.ir/images/generated/1234567890.jpg",
  "prompt": "یک پسر انیمه‌ای با چشم‌های آبی",
  "width": 512,
  "height": 512
}

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

• هر کلید API محدودیت تعداد درخواست در دقیقه دارد.
• اندازه تصویر پیش‌فرض 512x512 است، بزرگ‌تر یا کوچک‌تر ممکن است زمان تولید را افزایش دهد.
• متن پرامپت را کوتاه و دقیق وارد کنید تا نتیجه بهتر شود.
• اطلاعات حساس یا شخصی را در پرامپت وارد نکنید.
• در صورت بروز خطا، کد پاسخ HTTP و پیام خطا در JSON بازگردانده می‌شود.

ساختار دایرکتوری

در صورت استفاده از بسته آماده، ساختار دایرکتوری به صورت زیر است:

CAS/
│
├─ assets/      # تصاویر و فایل‌های مورد نیاز
├─ css/         # فایل‌های استایل
├─ js/          # فایل‌های جاوااسکریپت
├─ images/      # تصاویر نمونه
├─ vendor/      # کتابخانه‌های جانبی
└─ index.html   # نمونه صفحه تست

پشتیبانی

اگر این مستندات به سوالات شما پاسخ نداد، لطفاً از طریق صفحه پشتیبانی با ما تماس بگیرید.