للمطورين · API v1

API واحدة.
كل النماذج.

الصور والفيديو والصوت و3D عبر API واحدة. استدعها من Node أو Python أو curl، أو أتمتها من الطرفية عبر Genlaxy CLI، وكل ذلك مدفوع من الرصيد نفسه المستخدم في الاستوديو.

$npm i -g @genlaxy/cli
النماذج
641
نقاط النهاية
9
الحد الأدنى للشحن
‏5 €
01 · أمثلة

الاستدعاء نفسه، أي مخرجات

غيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.

1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8  method: "POST",9  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10  body: JSON.stringify({11    modelId: "luma/uni-v1/text-to-image",12    inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13  }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19  await new Promise((r) => setTimeout(r, 3000));20  ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
مثال على التوليدluma/uni-v1/text-to-image
02 · بدء سريع

أول عملية توليد في ثلاث خطوات

  1. 01أنشئ مفتاح APIسجّل الدخول ببريدك الإلكتروني، وافتح الإعدادات ثم مفاتيح API وأنشئ مفتاحًا. اشحن رصيدك بدءًا من ‏5 € في صفحة الفواتير.export GENLAXY_API_KEY="gl_live_..."
  2. 02ثبّت CLIأمر واحد، Node.js 18.3 أو أحدث. أو تجاوزها واستدعِ API بأي عميل HTTP.npm i -g @genlaxy/cli
  3. 03نفّذ أول عملية توليداختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIجديد

التوليد من الطرفية

شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.

السكربتات وCIكل حقل في النموذج خيار سطر أوامر، ويُرفع الملف المحلي نيابةً عنك.
JSON على stdoutمستند JSON واحد لكل تشغيل، والتقدم والأخطاء على stderr، ورمز خروج غير صفري عند الفشل.
وكلاء البرمجةملف مهارة يعلّم وكيلك أن يتحقق من السعر أولًا وأن يضع له حدًا.
دليل CLI الكامل →
الأمرما يفعله
genlaxy loginالصق مفتاح API مرة واحدة، فيُتحقق منه ويُحفظ
genlaxy whoamiاسم المفتاح ورصيدك
genlaxy models --type videoكل نماذج الفيديو مع سعرها الابتدائي
genlaxy run <model> -hحقول النموذج مباشرة: النوع والقيمة الافتراضية والقيم المسموح بها
genlaxy run <model> -p "<prompt>" -o ./out/التوليد وحفظ النتيجة في مجلد
genlaxy run <model> -p "..." --dry-runالسعر الدقيق دون إنفاق أي شيء
genlaxy run <model> -p "..." --max-price 0.50رفض التشغيل إذا كان السعر أعلى
genlaxy run <model> -p "..." --json -o ./out/نتيجة JSON واحدة جاهزة للخطوة التالية
genlaxy skill installعلّم وكيل البرمجة استخدام CLI
04 · أساسيات API

مصممة للإنتاج

المصادقة

رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.

Authorization: Bearer gl_live_...

التوليد في الخلفية

بدء عملية توليد يرد فورًا بالحالة queued. استعلم عنها حتى تنجح أو تفشل أو يُسترد مبلغها.

{ "status": "queued" }

السعر أولًا

اطلب السعر الدقيق لمدخلاتك دون بدء أي شيء. كل المبالغ بسنتات اليورو.

POST /api/v1/api/catalog/quote

إعادة محاولة آمنة

أرسل ترويسة Idempotency-Key ولن يُحتسب الطلب المعاد مرتين أبدًا.

Idempotency-Key: render-042

الحدود

لكل مفتاح حد في الدقيقة وسقف يومي اختياري. بعد تجاوز الحد ترد API بالرمز 429.

429 Too Many Requests

الأخطاء والاسترداد

أخطاء JSON برمز ورسالة. عملية التوليد التي تفشل يُرد مبلغها إلى رصيدك تلقائيًا.

{ "status": "refunded" }
05 · المرجع

نقاط النهاية

عنوان URL الأساسي https://genlaxy.ai/api/v1/api/catalog

مرجع API الكامل →
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حذف عملية توليد

اشحن ‏5 € وانطلق اليوم

API وCLI والاستوديو تتشارك رصيدًا واحدًا. عمليات التوليد الفاشلة يُرد مبلغها.