डेवलपर

Genlaxy API

कैटलॉग का हर मॉडल, आपके अपने कोड से। एक key, एक बैलेंस, स्टूडियो जैसी ही कीमतें।

1 · ऑथेंटिकेशन

सेटिंग्स में API keys पर जाकर एक key बनाएँ। हर रिक्वेस्ट के साथ इसे Bearer टोकन के रूप में भेजें। Keys gl_live_ से शुरू होती हैं और सिर्फ़ Genlaxy पर काम करती हैं; इन्हें अपने सर्वर पर रखें, कभी भी ब्राउज़र या ऐप में नहीं।

curl

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

2 · मॉडल चुनें

मॉडल चुनें और उसके अपने फ़ील्ड से बनी तैयार रिक्वेस्ट देखें। ज़रूरी फ़ील्ड पहले से भरे हैं; हर वैकल्पिक सेटिंग मॉडल का डिफ़ॉल्ट इस्तेमाल करती है।

चुना गया मॉडलkwaivgi/kling-video-o3-std/reference-to-video

मॉडल पेज →

फ़ील्ड
नाम	टाइप	ज़रूरी	डिफ़ॉल्ट
prompt	text	नहीं	-
video	url (video)	नहीं	-
images	url (image)	नहीं	-
keep_original_sound	toggle	नहीं	true
sound	toggle	नहीं	false
aspect_ratio	16:9 \| 9:16 \| 1:1	नहीं	16:9
duration	3 \| 4 \| 5 \| 6 \| 7 \| 8 \| ...	नहीं	5
shot_type	customize \| intelligence	नहीं	customize
multi_prompt	json	नहीं	-

3 · रेंडर शुरू करें

एक कॉल आपके सटीक इनपुट की कीमत तय करती है और बैलेंस से काट लेती है। जवाब तुरंत status 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": "kwaivgi/kling-video-o3-std/reference-to-video",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

पहले कीमत जाँचें (वैकल्पिक)

वही इनपुट, बिना कुछ शुरू किए कीमत के साथ। जवाब सेंट में होता है।

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"kwaivgi/kling-video-o3-std/reference-to-video","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · स्टेटस जाँचें और डाउनलोड करें

हर कुछ सेकंड में रेंडर का स्टेटस पूछें, जब तक status succeeded, failed या refunded न हो जाए। सफल होने पर उसी key से 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	आपकी 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	रेंडर हटाएँ

कीमतें और बैलेंस

API रेंडर स्टूडियो वाला ही बैलेंस इस्तेमाल करते हैं और उनकी कीमत भी वही है। API में हर रकम यूरो सेंट में होती है: costCents बताता है कि रेंडर पर कितना कटा, balanceCents बताता है कि कितना बचा है।

एरर और सीमाएँ

एरर JSON में एक कोड और संदेश के साथ लौटते हैं। 401: key नहीं है, गलत है या रद्द की गई है। 400: कोई फ़ील्ड अमान्य है (डिटेल में उसका नाम होता है)। 402: बैलेंस काफ़ी नहीं है। 409 API_KEY_DAILY_CAP: key की अपनी दैनिक सीमा पूरी हो गई है। 429: बहुत ज़्यादा रिक्वेस्ट, रफ़्तार कम करें। असफल रेंडर का पैसा अपने आप लौटा दिया जाता है।