Pengembang · API v1Segera hadir

Satu API.
Semua model.

Gambar, video, audio, dan 3D di balik satu API, dibayar dari saldo yang sama dengan studio. Buat kunci di Pengaturan; CLI segera hadir.

Dapatkan kunci APIMulai cepat

CLI Airogenia segera hadir. Halaman ini memperlihatkan cara kerjanya; sampai saat itu, gunakan API.

$npm i -g @airogenia/cli
Model
672
Endpoint
9
Isi saldo minimum
€3
01 · Contoh

Panggilan yang sama, output apa pun

Ganti ID model untuk beralih antara gambar, video, dan suara. Kolomnya mengikuti model.

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()));
Contoh renderluma/uni-v1/text-to-image
02 · Mulai cepat

Render pertama dalam tiga langkah

  1. 01Buat kunci APIMasuk dengan email Anda, buka Pengaturan, Kunci API, lalu buat kunci. Isi saldo mulai €3 di Tagihan.export AIROGENIA_API_KEY="ai_live_..."
  2. 02CLI segera hadirAlat baris perintah belum dirilis. Sampai saat itu, semuanya berjalan di studio.npm i -g @airogenia/cli
  3. 03Buat render pertamaPilih ID model dari katalog dan kirim prompt. Tambahkan --dry-run untuk melihat harga tanpa mengeluarkan apa pun.airogenia run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLISegera hadir

Render dari terminal

Jalankan model apa pun dari shell, job CI, atau agen coding. Setiap render diberi harga sebelum dimulai dan dibayar dari saldo yang sama.

Skrip dan CISetiap kolom model adalah flag; file lokal diunggah untuk Anda.
JSON di stdoutSatu dokumen JSON per eksekusi, progres dan error di stderr, kode keluar bukan nol jika gagal.
Agen codingFile skill mengajari agen Anda untuk memeriksa harga terlebih dahulu dan membatasinya.
Panduan lengkap CLI →
PerintahFungsinya
airogenia loginTempel kunci API Anda sekali; kunci diperiksa lalu disimpan
airogenia whoamiNama kunci dan saldo Anda
airogenia models --type videoSemua model video beserta harga awalnya
airogenia run <model> -hKolom sebuah model, diambil langsung: tipe, default, nilai yang diizinkan
airogenia run <model> -p "<prompt>" -o ./out/Render dan simpan hasilnya di folder
airogenia run <model> -p "..." --dry-runHarga pastinya, tanpa mengeluarkan apa pun
airogenia run <model> -p "..." --max-price 0.50Menolak berjalan jika harganya lebih tinggi
airogenia run <model> -p "..." --json -o ./out/Satu hasil JSON, siap untuk langkah berikutnya
airogenia skill installAjari agen coding Anda memakai CLI
04 · Dasar API

Siap untuk produksi

Autentikasi

Token Bearer di header Authorization. Buat kunci di Pengaturan dan cabut kunci mana pun kapan saja.

Authorization: Bearer ai_live_...

Render di latar belakang

Memulai render langsung menjawab dengan status queued. Polling render sampai berhasil, gagal, atau dikembalikan dananya.

{ "status": "queued" }

Harga dulu

Minta harga pasti untuk input Anda tanpa memulai apa pun. Semua jumlah dalam sen euro.

POST /api/v1/api/catalog/quote

Coba ulang dengan aman

Kirim header Idempotency-Key dan permintaan yang diulang tidak akan pernah ditagih dua kali.

Idempotency-Key: render-042

Batas

Setiap kunci punya batas per menit dan batas harian opsional. Melewati batas, API menjawab 429.

429 Too Many Requests

Error dan pengembalian dana

Error JSON dengan kode dan pesan. Render yang gagal otomatis dikembalikan ke saldo Anda.

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

Endpoint

URL dasarhttps://airogenia.com/api/v1/api/catalog

Referensi API lengkap →
GET/meKunci dan saldo Anda
GET/modelsSemua model
GET/models/detail?id=MODEL_IDSatu model dan kolomnya
POST/quoteHarga untuk input tertentu
POST/generationsMulai render
GET/generationsRender terbaru Anda
GET/generations/IDStatus satu render
GET/generations/ID/contentFile hasil
DELETE/generations/IDHapus render

Isi saldo €3 dan rilis hari ini

Buat kunci API di Pengaturan dan panggil model apa pun. CLI segera hadir. Render yang gagal dikembalikan.

Dapatkan kunci APILihat harga