المصادقة
رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer gl_live_...الصور والفيديو والصوت و3D عبر API واحدة. استدعها من Node أو Python أو curl، أو أتمتها من الطرفية عبر Genlaxy CLI، وكل ذلك مدفوع من الرصيد نفسه المستخدم في الاستوديو.
npm i -g @genlaxy/cliغيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.
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()));
export GENLAXY_API_KEY="gl_live_..."npm i -g @genlaxy/cligenlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.
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رمز 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" }/meمفتاحك ورصيدك/modelsكل النماذج/models/detail?id=MODEL_IDنموذج واحد وحقوله/quoteالسعر لمدخلات محددة/generationsبدء التوليد/generationsعمليات التوليد الأخيرة/generations/IDحالة عملية توليد واحدة/generations/ID/contentملف النتيجة/generations/IDحذف عملية توليداشحن 5 € وانطلق اليوم
API وCLI والاستوديو تتشارك رصيدًا واحدًا. عمليات التوليد الفاشلة يُرد مبلغها.