واجهة Genlaxy البرمجية
كل نموذج في الكتالوج، من شيفرتك الخاصة. مفتاح واحد، ورصيد واحد، والأسعار نفسها كما في الاستوديو.
1 · المصادقة
أنشئ مفتاحًا من الإعدادات، مفاتيح API. أرسله مع كل طلب كرمز Bearer. تبدأ المفاتيح بـ gl_live_ وتعمل على Genlaxy فقط؛ احتفظ بها على خادمك، ولا تضعها أبدًا في متصفح أو تطبيق.
curl https://genlaxy.ai/api/v1/api/catalog/me \
-H 'Authorization: Bearer gl_live_...'2 · اختر نموذجًا
اختر نموذجًا لترى طلبًا جاهزًا مبنيًا من حقوله الخاصة. الحقول المطلوبة معبأة، وكل إعداد اختياري يستخدم القيمة الافتراضية للنموذج.
recraft-ai/recraft-v4.1-pro/text-to-vector| الاسم | النوع | مطلوب | الافتراضي |
|---|---|---|---|
| prompt | text | نعم | - |
| image_size | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | لا | 1:1 |
3 · ابدأ التوليد
استدعاء واحد يحسب سعر مدخلاتك بالضبط ويخصمه من رصيدك. تعود الاستجابة فورًا بالحالة queued، ويعمل التوليد في الخلفية. أرسل ترويسة Idempotency-Key حتى لا يُخصم المبلغ مرتين عند إعادة إرسال الطلب.
curl -X POST https://genlaxy.ai/api/v1/api/catalog/generations \
-H 'Authorization: Bearer gl_live_...' \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"modelId": "recraft-ai/recraft-v4.1-pro/text-to-vector",
"inputs": {
"prompt": "a lighthouse on a cliff at dusk, soft light"
}
}'تحقق من السعر أولًا (اختياري)
المدخلات نفسها، مسعّرة دون بدء أي شيء. الإجابة بالسنت.
curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
-H 'Authorization: Bearer gl_live_...' \
-H 'Content-Type: application/json' \
-d '{"modelId":"recraft-ai/recraft-v4.1-pro/text-to-vector","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'4 · استعلم ونزّل
اطلب حالة التوليد كل بضع ثوانٍ حتى تصبح succeeded أو failed أو refunded. عند النجاح، نزّل الملف من contentUrl بالمفتاح نفسه. أما النموذج النصي فيعيد إجابته في textOutput بدلًا من ذلك.
curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
-H 'Authorization: Bearer gl_live_...'curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
-H 'Authorization: Bearer gl_live_...' \
-o result.pngنقاط النهاية
عنوان URL الأساسي: https://genlaxy.ai/api/v1/api/catalog
| GET | /me | مفتاحك ورصيدك |
| GET | /models | كل النماذج |
| GET | /models/detail?id=MODEL_ID | نموذج واحد وحقوله |
| POST | /quote | السعر لمدخلات محددة |
| POST | /generations | بدء التوليد |
| GET | /generations | عمليات التوليد الأخيرة |
| GET | /generations/ID | حالة عملية توليد واحدة |
| GET | /generations/ID/content | ملف النتيجة |
| DELETE | /generations/ID | حذف عملية توليد |
الأسعار والرصيد
تستخدم عمليات التوليد عبر API الرصيد نفسه المستخدم في الاستوديو وبالتكلفة نفسها. كل المبالغ في API بسنتات اليورو: costCents هو ما خُصم مقابل التوليد، وbalanceCents هو المتبقي.
الأخطاء والحدود
تعود الأخطاء بصيغة JSON مع رمز ورسالة. 401: المفتاح مفقود أو خاطئ أو ملغى. 400: أحد الحقول غير صالح (تذكره التفاصيل). 402: الرصيد غير كافٍ. 409 API_KEY_DAILY_CAP: تم بلوغ الحد اليومي للمفتاح. 429: طلبات كثيرة جدًا، خفف السرعة. تُسترد قيمة التوليد الفاشل تلقائيًا.