डेवलपर · API v1

एक API.
हर मॉडल.

इमेज, वीडियो, ऑडियो और 3D, सब एक API के पीछे। इसे Node, Python या curl से कॉल करें, या Genlaxy CLI से टर्मिनल में स्क्रिप्ट करें, भुगतान स्टूडियो वाले उसी बैलेंस से।

$npm i -g @genlaxy/cli
मॉडल
641
एंडपॉइंट
9
न्यूनतम टॉप-अप
€5
01 · उदाहरण

एक ही कॉल, कोई भी आउटपुट

इमेज, वीडियो और स्पीच के बीच बदलने के लिए बस मॉडल ID बदलें। फ़ील्ड मॉडल के अनुसार होते हैं।

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. 01API key बनाएँअपने ईमेल से साइन इन करें, Settings में API keys खोलें और एक key बनाएँ। Billing में €5 से टॉप-अप करें।export GENLAXY_API_KEY="gl_live_..."
  2. 02CLI इंस्टॉल करेंएक कमांड, Node.js 18.3 या नया। या इसे छोड़ें और किसी भी HTTP क्लाइंट से API कॉल करें।npm i -g @genlaxy/cli
  3. 03पहला रेंडर करेंकैटलॉग से मॉडल ID चुनें और प्रॉम्प्ट भेजें। बिना कुछ खर्च किए कीमत देखने के लिए --dry-run जोड़ें।genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIनया

टर्मिनल से रेंडर करें

किसी भी मॉडल को shell, CI जॉब या कोडिंग एजेंट से चलाएँ। हर रेंडर की कीमत शुरू होने से पहले तय होती है और उसी बैलेंस से कटती है।

स्क्रिप्ट और CIमॉडल का हर फ़ील्ड एक फ़्लैग है; लोकल फ़ाइल आपके लिए अपलोड हो जाती है।
stdout पर JSONहर रन पर एक JSON डॉक्यूमेंट, प्रोग्रेस और एरर stderr पर, विफल होने पर नॉन-ज़ीरो एग्ज़िट कोड।
कोडिंग एजेंटएक skill फ़ाइल आपके एजेंट को पहले कीमत जाँचना और उसकी सीमा तय करना सिखाती है।
पूरी CLI गाइड →
कमांडयह क्या करता है
genlaxy loginअपनी API key एक बार पेस्ट करें; वह जाँचकर सेव हो जाती है
genlaxy whoamikey का नाम और आपका बैलेंस
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 की ज़रूरी बातें

प्रोडक्शन के लिए बना

ऑथेंटिकेशन

Authorization हेडर में एक Bearer टोकन। Settings में keys बनाएँ और किसी को भी कभी भी रद्द करें।

Authorization: Bearer gl_live_...

बैकग्राउंड रेंडर

रेंडर शुरू करने पर तुरंत queued स्टेटस मिलता है। रेंडर को तब तक पोल करें जब तक वह सफल, विफल या रिफ़ंड न हो जाए।

{ "status": "queued" }

पहले कीमत

कुछ भी शुरू किए बिना अपने इनपुट की सटीक कीमत पूछें। हर राशि यूरो सेंट में है।

POST /api/v1/api/catalog/quote

सुरक्षित रीट्राई

Idempotency-Key हेडर भेजें, तो दोबारा भेजा गया अनुरोध कभी दो बार चार्ज नहीं होगा।

Idempotency-Key: render-042

सीमाएँ

हर key की प्रति मिनट सीमा और एक वैकल्पिक दैनिक सीमा होती है। सीमा पार होने पर API 429 लौटाता है।

429 Too Many Requests

एरर और रिफ़ंड

कोड और मैसेज के साथ JSON एरर। विफल रेंडर अपने आप आपके बैलेंस में रिफ़ंड हो जाता है।

{ "status": "refunded" }
05 · रेफ़रेंस

एंडपॉइंट

बेस URL https://genlaxy.ai/api/v1/api/catalog

पूरा API रेफ़रेंस →
GET/meआपकी key और बैलेंस
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 और स्टूडियो एक ही बैलेंस साझा करते हैं। विफल रेंडर रिफ़ंड होते हैं।