API pembuat gambar AI untuk semua model

Sekilas info

API pembuat gambar AI Mage adalah REST API di https://api.mage.space/v1 yang menjalankan 15 model text-to-image dan pengeditan gambar, termasuk Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2, dan Krea 2. Kamu mengirim (POST) prompt ke /{model}/generate, melakukan polling pada permintaan, lalu mengunduh gambarnya. Setiap gambar dibayar dengan Gems, tanpa langganan.

• 15

  model gambar

• $0.009

  Default termurah, per gambar

• 20

  Proses generate bersamaan

• $0

  Biaya bulanan

Model

Semua model gambar di Mage API

Harga dihitung per proses generate, dalam Gems. 1.000 Gems seharga $1 pada paket standar, dan paket yang lebih besar memberi bonus Gems. Harga bergantung pada model, resolusi, dan durasi; yang ditampilkan adalah harga dengan pengaturan default, dan setiap respons mencantumkan biaya pastinya di billing.gems_charged. Proses generate yang gagal akan dikembalikan Gems-nya; yang diblokir oleh kebijakan konten Mage tidak.

Mulai cepat

Buat gambar dengan Anima v1

Setel MAGE_API_KEY, kirim permintaan, lalu lakukan polling sampai selesai. Ganti anima di URL dengan model mana pun di atas.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "anima-v1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

print(request["result"]["url"])

Cara kerjanya

Dari kunci API sampai media jadi dalam tiga panggilan

Semua model memakai satu skema autentikasi, satu siklus permintaan asinkron, dan nama field yang sama.

1. 01

   Buat kunci API

   Masuk ke Mage, buka API → API Keys, lalu buat kunci. Kunci diawali mage_sk_ dan hanya ditampilkan sekali. Satu akun bisa memiliki 10 kunci aktif.

2. 02

   Kirim permintaan generasi

   Kirim POST dengan body JSON ke https://api.mage.space/v1/{model}/generate beserta header Authorization: Bearer. Respons langsung kembali dengan request_id, status, dan status_url. Sertakan header Idempotency-Key agar percobaan ulang tidak pernah membayar dua kali.

3. 03

   Cek status dan unduh

   Lakukan polling ke status_url sampai statusnya completed, failed, atau cancelled. Permintaan yang selesai membawa result.url berisi file gambar, video, atau audio, yang disimpan selama 30 hari.

Siap untuk produksi

Yang didapat setiap permintaan Mage API

Kasus penggunaan

Apa yang dibuat developer dengan API gambar

FAQ

Pertanyaan yang sering diajukan

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

Terkait

• API pembuat video AI
• API pembuat audio AI
• Server MCP Mage
• SDK Mage
• Mage untuk ComfyUI
• Semua model API
• Playground API
• Dokumentasi API