API dan server MCP
Generate dari Claude, Cursor, atau skrip Anda sendiri dengan kunci API: model yang sama, kredit yang sama, kegagalan dikembalikan.
Imaginode di luar canvas
Semua yang bisa dihasilkan canvas juga tersedia di luarnya: sebuah API REST dan server MCP (Model Context Protocol) memungkinkan agen AI atau skrip membuat gambar dan video dengan akun Anda. Panggilan memakai kredit dari saldo Anda, dengan harga yang sama seperti di canvas, dan generasi yang gagal dikembalikan otomatis, seperti biasa.
MCP adalah standar yang memungkinkan asisten AI (Claude, Cursor, dan banyak lainnya) memakai alat eksternal. Begitu Imaginode terhubung, asisten Anda bisa menghasilkan gambar di tengah percakapan, mengilustrasikan artikel yang sedang ditulisnya, atau memproduksi visual sebuah workflow otomatis.
Membuat kunci API
Buka profil Anda, bagian "Kunci API". Beri nama kunci itu ("Claude Code", "skrip blog"…) lalu buat: rahasia imk_… hanya ditampilkan satu kali, salin segera. Maksimal lima kunci aktif, bisa dicabut kapan saja dengan satu klik; kunci yang dicabut langsung berhenti berfungsi.
Pembuatannya memerlukan email terverifikasi, dan setiap kunci dibatasi 10 generasi per menit: cukup untuk bekerja dengan nyaman, tidak cukup untuk menguras saldo tanpa sengaja jika sebuah agen lepas kendali.
Menghubungkan server MCP
Alamat servernya https://imaginode.ai/api/mcp (transport Streamable HTTP). Autentikasi dengan mengirim kunci Anda di header "Authorization: Bearer imk_…". Di Claude Code, cukup satu perintah: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer kunci-anda". Di Claude.ai atau Cursor, tambahkan konektor kustom dengan alamat dan header yang sama.
Empat alat tersedia. list_models mengembalikan katalog dan harga dalam kredit. generate_image membuat gambar dan menunggu hasilnya: URL-nya dikembalikan langsung. generate_video memulai video dan mengembalikan id pelacakan. get_generation_status mengikuti sebuah generasi sampai URL finalnya.
API REST langsung
Untuk skrip Anda, tiga endpoint sudah cukup. GET /api/models menampilkan daftar model, opsi, dan harganya, tanpa autentikasi. POST /api/generate memulai generasi: JSON berisi model, prompt, dan opsi si model (duration, resolution, aspectRatio, audio, imageUrls), kunci di header Authorization, dan responsnya memuat requestId, cost, serta saldo baru Anda. GET /api/generate/status?requestId=… mengembalikan running, lalu completed dengan URL keluaran, atau failed dengan pengembalian kredit.
Gambar masukan (imageUrls) harus berupa media yang tersimpan di akun Imaginode Anda: impor dulu ke media Anda, atau pakai ulang URL dari generasi sebelumnya.
Praktik terbaik
Mulailah dengan model ekonomis (Flux Schnell, 1 kredit) untuk memvalidasi prompt sebelum beralih ke model premium. Untuk video, cek statusnya setiap 30 detik: perkirakan 1 sampai 5 menit pada umumnya, sampai 30 menit untuk generasi panjang. Biaya persisnya dikembalikan sejak peluncuran, bahkan sebelum hasilnya keluar.
Kunci adalah rahasia: jangan commit ke repositori dan jangan dibagikan. Sedikit saja ragu, cabut dari profil Anda dan buat yang baru.