डेवलपर · API v1जल्द आ रहा है

एक API.
हर मॉडल.

इमेज, वीडियो, ऑडियो और 3D एक API के पीछे, स्टूडियो वाले ही बैलेंस से। कुंजी सेटिंग्स में बनाएं; CLI जल्द आ रहा है।

Airogenia CLI जल्द आ रहा है। यह पेज दिखाता है कि वह कैसे काम करेगा; तब तक API का उपयोग करें।

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

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

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

1import { writeFile } from "node:fs/promises";2 3const API = "https://airogenia.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.AIROGENIA_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 में €3 से टॉप-अप करें।export AIROGENIA_API_KEY="ai_live_..."
  2. 02CLI जल्द आ रहा हैकमांड-लाइन टूल अभी प्रकाशित नहीं हुआ है। तब तक सब कुछ स्टूडियो में चलता है।npm i -g @airogenia/cli
  3. 03पहला रेंडर करेंकैटलॉग से मॉडल ID चुनें और प्रॉम्प्ट भेजें। बिना कुछ खर्च किए कीमत देखने के लिए --dry-run जोड़ें।airogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIजल्द आ रहा है

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

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

स्क्रिप्ट और CIमॉडल का हर फ़ील्ड एक फ़्लैग है; लोकल फ़ाइल आपके लिए अपलोड हो जाती है।
stdout पर JSONहर रन पर एक JSON डॉक्यूमेंट, प्रोग्रेस और एरर stderr पर, विफल होने पर नॉन-ज़ीरो एग्ज़िट कोड।
कोडिंग एजेंटएक skill फ़ाइल आपके एजेंट को पहले कीमत जाँचना और उसकी सीमा तय करना सिखाती है।
पूरी CLI गाइड →
कमांडयह क्या करता है
airogenia loginअपनी API key एक बार पेस्ट करें; वह जाँचकर सेव हो जाती है
airogenia whoamikey का नाम और आपका बैलेंस
airogenia models --type videoहर वीडियो मॉडल उसकी शुरुआती कीमत के साथ
airogenia run <model> -hमॉडल के फ़ील्ड, लाइव: टाइप, डिफ़ॉल्ट, अनुमत मान
airogenia run <model> -p "<prompt>" -o ./out/रेंडर करें और नतीजा एक फ़ोल्डर में सेव करें
airogenia run <model> -p "..." --dry-runसटीक कीमत, बिना कुछ खर्च किए
airogenia run <model> -p "..." --max-price 0.50कीमत ज़्यादा हो तो चलाने से मना करें
airogenia run <model> -p "..." --json -o ./out/एक JSON नतीजा, अगले चरण के लिए तैयार
airogenia skill installअपने कोडिंग एजेंट को CLI इस्तेमाल करना सिखाएँ
04 · API की ज़रूरी बातें

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

ऑथेंटिकेशन

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

Authorization: Bearer ai_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 · रेफ़रेंस

एंडपॉइंट

बेस URLhttps://airogenia.com/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रेंडर हटाएँ

€3 टॉप-अप करें और आज ही शिप करें

सेटिंग्स में API कुंजी बनाएं और कोई भी मॉडल चलाएं। CLI जल्द आ रहा है। विफल रेंडर लौटा दिए जाते हैं।