المصادقة
رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer ai_live_...صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات؛ أداة CLI قادمة قريبًا.
أداة Airogenia CLI في الطريق. تعرض هذه الصفحة كيف ستعمل؛ وحتى ذلك الحين استخدم واجهة API.
npm i -g @airogenia/cliغيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.
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()));
export AIROGENIA_API_KEY="ai_live_..."npm i -g @airogenia/cliairogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.
airogenia loginالصق مفتاح API مرة واحدة، فيُتحقق منه ويُحفظairogenia whoamiاسم المفتاح ورصيدك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رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer ai_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حذف عملية توليداشحن 3 € وانطلق اليوم
أنشئ مفتاح API من الإعدادات واستدعِ أي نموذج. أداة CLI قادمة قريبًا. تُسترد العمليات الفاشلة.