v3.0.0

وثائق API

دليل شامل لدمج خدمات Alyachan API. الوصول إلى نقاط نهاية الذكاء الاصطناعي وبرامج تنزيل الوسائط وأدوات البيانات مع معايير RESTful آمنة وقابلة للتوسع.

01 — البدء

إعداد الحساب

الوصول إلى نقاط نهاية API يتطلب حساباً موثقاً. نوفر خيارات تسجيل مرنة (البريد الإلكتروني، Google، Discord) لتسريع عملية التكامل الخاصة بك.

Register UI

إدارة مفاتيح API

بعد تسجيل الدخول، انتقل إلى لوحة تحكم الحساب في علامة التبويب "API KEY". هذا المفتاح هو بيانات اعتماد التطبيق السرية الخاصة بك.

◦ لاسترداد مفتاح API الخاص بك، يرجى الضغط على زر "نسخ"

API Key Dashboard

◦ لتغيير مفتاح API الخاص بك، يرجى الضغط على زر "إنشاء مفتاح" متبوعاً بزر "تحديث المفتاح"

API Key Dashboard

القائمة البيضاء لعناوين IP خطة الاشتراك

ميزة أمان لتقييد الوصول إلى مفتاح API فقط من عناوين IP المسجلة للخادم. يجب عليك إعداد IP قبل استخدام مفتاح API الخاص بك

  • IP ثابت: تسجيل IP خادم الإنتاج يدوياً.
  • السماح للجميع: حدد هذا الخيار إذا كان الخادم يستخدم IP ديناميكي (غير موصى به للإنتاج).
IP Whitelist

02 — التكامل

تثبيت المكتبة

SDK الرسمي
npm install @alyachan/api
HTTP عام
npm install axios

أمثلة الاستخدام

للحصول على / البحث عن نقاط النهاية، يرجى زيارة مرجع API

الخادم الرئيسي : https://api.alyachan.dev

الخوادم الاحتياطية :

  • https://api-v2.alyachan.dev
index.js (SDK)موصى به
const AlyaApi = require('@alyachan/api').default
const Api = AlyaApi('https://api.alyachan.dev/api', 'sk_prod_xxxxxxxx')

async function main() {
  try {
    const res = await Api.post('/ai/text2img', {
      'prompt': 'Cyberpunk city',
      'models': 'Japanese'
    })
    console.log(res)
  } catch (e) {
    console.error(e)
  }
}
request.js (Axios) POST
const axios = require('axios')

const config = {
  'method': 'POST',
  'url': 'https://api.alyachan.dev/api/ai/text2img',
  'headers': {
    'Authorization': 'Bearer sk_prod_xxxxxxxx',
    'Content-Type': 'application/json'
  },
  'data': { 'prompt': 'Cyberpunk city', 'models': 'Japanese' }
}

axios(config)
  .then(r => console.log(r.data))
  .catch(e => console.error(e))

الاستجابات القياسية

الكودالمعنىالوصف
200OKتمت معالجة الطلب بنجاح.
400طلب خاطئمعاملات الإدخال غير صحيحة أو مفقودة.
401غير مصرحمفتاح API غير صالح أو غير مقدم.
429حد المعدلتم تجاوز حد الطلبات اليومية.

© 2026 Alyachan API. All rights reserved.