للمطورين

واجهة Genlaxy البرمجية

كل نموذج في الكتالوج، من شيفرتك الخاصة. مفتاح واحد، ورصيد واحد، والأسعار نفسها كما في الاستوديو.

1 · المصادقة

أنشئ مفتاحًا من الإعدادات، مفاتيح API. أرسله مع كل طلب كرمز Bearer. تبدأ المفاتيح بـ gl_live_ وتعمل على Genlaxy فقط؛ احتفظ بها على خادمك، ولا تضعها أبدًا في متصفح أو تطبيق.

curl

curl https://genlaxy.ai/api/v1/api/catalog/me \
  -H 'Authorization: Bearer gl_live_...'

2 · اختر نموذجًا

اختر نموذجًا لترى طلبًا جاهزًا مبنيًا من حقوله الخاصة. الحقول المطلوبة معبأة، وكل إعداد اختياري يستخدم القيمة الافتراضية للنموذج.

النموذج المحددpixverse/pixverse-v4.5-t2v-fast

صفحة النموذج →

الحقول
الاسم	النوع	مطلوب	الافتراضي
prompt	text	نعم	-
aspect_ratio	16:9 \| 4:3 \| 1:1 \| 3:4 \| 9:16	نعم	16:9
resolution	360p \| 540p \| 720p	نعم	540p
duration	5	لا	5
negative_prompt	text	لا	-
seed	number	لا	-

3 · ابدأ التوليد

استدعاء واحد يحسب سعر مدخلاتك بالضبط ويخصمه من رصيدك. تعود الاستجابة فورًا بالحالة queued، ويعمل التوليد في الخلفية. أرسل ترويسة Idempotency-Key حتى لا يُخصم المبلغ مرتين عند إعادة إرسال الطلب.

curl

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": "pixverse/pixverse-v4.5-t2v-fast",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light",
    "aspect_ratio": "16:9",
    "resolution": "540p"
  }
}'

تحقق من السعر أولًا (اختياري)

المدخلات نفسها، مسعّرة دون بدء أي شيء. الإجابة بالسنت.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"pixverse/pixverse-v4.5-t2v-fast","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light","aspect_ratio":"16:9","resolution":"540p"}}'

4 · استعلم ونزّل

اطلب حالة التوليد كل بضع ثوانٍ حتى تصبح succeeded أو failed أو refunded. عند النجاح، نزّل الملف من contentUrl بالمفتاح نفسه. أما النموذج النصي فيعيد إجابته في textOutput بدلًا من ذلك.

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer gl_live_...' \
  -o result.mp4

نقاط النهاية

عنوان 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: طلبات كثيرة جدًا، خفف السرعة. تُسترد قيمة التوليد الفاشل تلقائيًا.