Entwickler · API v1Demnächst

Eine API.
Jedes Modell.

Bilder, Video, Audio und 3D hinter einer API, bezahlt vom selben Guthaben wie das Studio. Erstelle einen Schlüssel in den Einstellungen; die CLI folgt bald.

API-Schlüssel holenSchnellstart

Die Airogenia-CLI ist unterwegs. Diese Seite zeigt vorab, wie sie funktioniert; bis dahin nutze die API.

$npm i -g @airogenia/cli
Modelle
672
Endpunkte
9
Mindestaufladung
3 €
01 · Beispiele

Derselbe Aufruf, jede Ausgabe

Tausche die Modell-ID, um zwischen Bild, Video und Sprache zu wechseln. Die Felder richten sich nach dem Modell.

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()));
Beispiel-Renderingluma/uni-v1/text-to-image
02 · Schnellstart

Der erste Render in drei Schritten

  1. 01API-Schlüssel erstellenMelde dich mit deiner E-Mail an, öffne Einstellungen, API-Schlüssel und erstelle einen Schlüssel. Lade ab 3 € unter Abrechnung auf.export AIROGENIA_API_KEY="ai_live_..."
  2. 02Die CLI kommt baldDas Kommandozeilen-Tool ist noch nicht veröffentlicht. Bis dahin läuft alles im Studio.npm i -g @airogenia/cli
  3. 03Ersten Render startenWähle eine Modell-ID aus dem Katalog und sende einen Prompt. Mit --dry-run siehst du den Preis, ohne etwas auszugeben.airogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIDemnächst

Rendern im Terminal

Starte jedes Modell aus einer Shell, einem CI-Job oder einem Coding-Agenten. Jeder Render wird vor dem Start bepreist und aus demselben Guthaben bezahlt.

Skripte und CIJedes Feld eines Modells ist ein Flag; eine lokale Datei wird für dich hochgeladen.
JSON auf stdoutEin JSON-Dokument pro Lauf, Fortschritt und Fehler auf stderr, ein Exit-Code ungleich null bei Fehlern.
Coding-AgentenEine Skill-Datei bringt deinem Agenten bei, erst den Preis zu prüfen und ihn zu begrenzen.
Vollständige CLI-Anleitung →
BefehlWas er tut
airogenia loginFüge deinen API-Schlüssel einmal ein; er wird geprüft und gespeichert
airogenia whoamiDer Name des Schlüssels und dein Guthaben
airogenia models --type videoAlle Videomodelle mit ihrem Startpreis
airogenia run <model> -hDie Felder eines Modells, live abgerufen: Typ, Standardwert, erlaubte Werte
airogenia run <model> -p "<prompt>" -o ./out/Rendern und das Ergebnis in einem Ordner speichern
airogenia run <model> -p "..." --dry-runDer genaue Preis, ohne etwas auszugeben
airogenia run <model> -p "..." --max-price 0.50Nicht starten, wenn der Preis höher ist
airogenia run <model> -p "..." --json -o ./out/Ein JSON-Ergebnis, bereit für den nächsten Schritt
airogenia skill installBring deinem Coding-Agenten die CLI bei
04 · API-Grundlagen

Gebaut für die Produktion

Authentifizierung

Ein Bearer-Token im Authorization-Header. Erstelle Schlüssel in den Einstellungen und widerrufe jeden davon jederzeit.

Authorization: Bearer ai_live_...

Renders im Hintergrund

Der Start eines Renders antwortet sofort mit dem Status queued. Frag den Render ab, bis er erfolgreich ist, fehlschlägt oder erstattet wurde.

{ "status": "queued" }

Erst der Preis

Frag den genauen Preis deiner Eingaben ab, ohne etwas zu starten. Alle Beträge sind in Euro-Cent.

POST /api/v1/api/catalog/quote

Sichere Wiederholungen

Sende einen Idempotency-Key-Header, und eine wiederholte Anfrage wird nie doppelt berechnet.

Idempotency-Key: render-042

Limits

Jeder Schlüssel hat ein Limit pro Minute und ein optionales Tageslimit. Darüber antwortet die API mit 429.

429 Too Many Requests

Fehler und Erstattungen

JSON-Fehler mit Code und Meldung. Ein fehlgeschlagener Render wird automatisch deinem Guthaben erstattet.

{ "status": "refunded" }
05 · Referenz

Endpunkte

Basis-URLhttps://airogenia.com/api/v1/api/catalog

Vollständige API-Referenz →
GET/meDein Schlüssel und Guthaben
GET/modelsAlle Modelle
GET/models/detail?id=MODEL_IDEin Modell und seine Felder
POST/quotePreis für genaue Eingaben
POST/generationsRendering starten
GET/generationsDeine letzten Renderings
GET/generations/IDStatus eines Renderings
GET/generations/ID/contentDie Ergebnisdatei
DELETE/generations/IDRendering löschen

Lade 3 € auf und leg heute los

Erstelle in den Einstellungen einen API-Schlüssel und rufe jedes Modell auf. Die CLI folgt bald. Fehlgeschlagene Renders werden erstattet.

API-Schlüssel holenPreise ansehen