Atlas AI — Developer API

واجهة برمجية مجانية للمطورين المغاربة 🇲🇦 — ذكاء اصطناعي بـ Llama و FLUX
100 طلب / يوم مجاناً

1 احصل على مفتاحك الآن — مجانًا

عبّي المعلومات، وافق على الشروط، واضغط الزر — المفتاح ديالك غادي يتولد فالحين:

2 التوثيق الكامل — طريقة الاستخدام

كل الطلبات POST على نفس الرابط، والجواب دائمًا JSON.

POST https://atlas-api.cardnova56.workers.dev
Content-Type: application/json
X-API-Key: atlas_sk_مفتاحك_هنا

الـ body كيكون JSON فيه action + باقي المعطيات. الجواب فيه ok: true أو ok: false مع سبب الخطأ.

2 الرابط الأساسي والصيغة

كل الطلبات POST على نفس الرابط:

POST https://atlas-api.cardnova56.workers.dev
Content-Type: application/json
X-API-Key: atlas_sk_مفتاحك_هنا

الـ body كيكون JSON فيه action + باقي المعطيات. الجواب دائماً JSON فيه ok: true أو ok: false مع سبب الخطأ.

4 الوظائف المتاحة

الوظيفةactionالمعطيات
محادثة نصيةchatmessages (مصفوفة), model (fast/balanced/smart), system (اختياري)
تحليل الصورvisionimage (base64), question
توليد الصورimageprompt
بحث ويبsearchq
أخبارnews
معلومات المفتاحdev_key_info— (الرصيد والاستهلاك)

5 أمثلة جاهزة

محادثة (cURL):

curl -X POST https://atlas-api.cardnova56.workers.dev \
  -H "Content-Type: application/json" \
  -H "X-API-Key: atlas_sk_..." \
  -d '{"action":"chat","messages":[{"role":"user","content":"سلام، شحالك؟"}]}'

JavaScript:

const res = await fetch("https://atlas-api.cardnova56.workers.dev", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": ATLAS_KEY },
  body: JSON.stringify({
    action: "chat",
    model: "balanced", // fast | balanced | smart
    messages: [{ role: "user", content: "شكون نتا؟" }]
  })
});
const data = await res.json(); // { ok, reply, usage: {used_today, limit} }

Python:

import requests
r = requests.post("https://atlas-api.cardnova56.workers.dev",
    headers={"X-API-Key": ATLAS_KEY},
    json={"action": "chat", "messages": [{"role": "user", "content": "صباح الخير"}]})
print(r.json()["reply"])

توليد صورة:

curl -X POST https://atlas-api.cardnova56.workers.dev \
  -H "Content-Type: application/json" \
  -H "X-API-Key: atlas_sk_..." \
  -d '{"action":"image","prompt":"a cat wearing a moroccan fez"}'
// الجواب: { ok: true, url: "data:image/jpeg;base64,..." }

التحقق من الرصيد:

curl -X POST https://atlas-api.cardnova56.workers.dev \
  -H "X-API-Key: atlas_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"dev_key_info"}'
// { ok, name, used_today, limit, remaining }

6 الحدود والأسعار

البندالقيمة
الطلبات اليومية لكل مفتاح100 طلب/يوم (كل الوظائف مجمعة)
السعرمجاني 100%
التجاوزHTTP 429 + error: dev_limit — كيرجع غدا معا الصباح
مفتاح غير صالحHTTP 401 + error: invalid_key

7 الشروط والأحكام

باستعمالك لمفتاح Atlas AI API، كتوافق على الشروط التالية:

1. الاستعمال الشخصي والتطويري فقط — ماتستعملش الـ API في أغراض تجارية كبار (بيعت النموذج نفسه، إعادة البيع) بلا اتفاق مكتوب.

2. محتوى قانوني — ممنوع توليد أو نشر محتوى غير قانوني، كراهية، عنف، أو أي شي مخالف للقانون المغربي.

3. حدود الاستهلاك — الحد اليومي 100 طلب. ماتحاولش تتجاوزه بمفاتيح متعددة أو أي حيلة تقنية.

4. الأمان — المفتاح مسؤوليتك. ماتشاركهش علناً. أي تسرب = سحب فوري للمفتاح.

5. الخدمة "كما هي" — بدون ضمانات. ممكن يتوقف الخدمة مؤقتاً للصيانة. ماصاوبيناش مسؤولين على الأضرار الناتجة عن استعمالك.

6. حق السحب — صاحب الخدمة كيقدر يسحب أو يوقف أي مفتاح فأي وقت بلا إشعار مسبق إلا مااحترمت الشروط.

7. الخصوصية — كنسجلو غير الاستهلاك (عداد يومي) واسم المفتاح. ماتوجد محتوى المحادثات.

8 Terms & Conditions (English summary)

By using an Atlas AI API key you agree to: (1) personal/development use only — no reselling the service itself; (2) no illegal, hateful, or harmful content per Moroccan law; (3) respecting the daily limit of 100 requests — no key-farming or bypass tricks; (4) keeping your key private — leaked keys are revoked immediately; (5) the service is provided "as is" with no warranty; (6) keys may be revoked at any time for violations; (7) we log only usage counters and key names, never conversation content.