وثائق واجهة برمجة تطبيقات توليد صور الذكاء الاصطناعي (v1)

توفر نقطة النهاية هذه بوابة وكيل آمنة، مما يسمح لك بتشغيل نماذج توليد صور الذكاء الاصطناعي دون الكشف عن بيانات اعتماد مزود الخدمة الأساسي الخاص بك.

1. نظرة عامة

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. المصادقة

يجب أن تتضمن جميع الطلبات رمز أمان في رأس HTTP لمنع الوصول غير المصرح به. يجب عليك الحصول على هذا الرمز من المسؤول الخاص بك.

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. معلمات الطلب

يجب إرسال جميع المعلمات في نص طلب JSON.

معلمة	النوع	مطلوب	الوصف
موجه	سلسلة نصية	نعم	وصف نصي للصورة التي تريد إنشاءها.
الحجم	سلسلة نصية	لا	دقة الصورة. الافتراضي: `1024x1024`القيم المدعومة: `256x256`, `512x512`, `1024x1024`
عدد الصور المراد توليدها	integer	لا	عدد الصور المراد توليدها. الافتراضي: `1`النطاق الموصى به: `1–4`

4. مثال cURL

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. مثال JavaScript

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. تنسيق الاستجابة

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. استجابات الخطأ

في حالة حدوث خطأ، ستقوم واجهة برمجة التطبيقات (API) بإرجاع رسالة خطأ بتنسيق JSON.

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. رموز الحالة

كود / رمز	المعنى
200	تم الطلب بنجاح
400	معلمات الطلب غير صالحة
403	رمز API غير صالح أو مفقود
500	فشل خدمة الذكاء الاصطناعي عن بُعد أو انتهت مهلتها