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 belas alat tersedia. list_models menampilkan katalog, apa yang dilakukan setiap model, dan harganya dalam kredit; get_balance membaca saldo Anda, untuk memeriksa apakah suatu pembuatan sudah tercukupi sebelum dijalankan. list_templates dan get_template menjelaskan template kanvas: model, instruksi, pengabelan, contoh, dan tautan yang membukanya siap untuk dijalankan. generate_image membuat gambar dan menunggu hasilnya: URL langsung dikembalikan. generate_video menjalankan video (gambar awal, gambar akhir, gambar referensi) dan mengembalikan id pelacakan. generate_speech membacakan teks atau dialog dengan suara dari katalog atau salah satu suara Anda yang telah dikloning, generate_sound menghasilkan efek suara atau musik, enhance_audio membersihkan, mengisolasi, atau memisahkan berkas audio. edit_image memperbesar resolusi, menghapus latar belakang, atau mengubah foto menjadi objek 3D; edit_video memperbesar resolusi, menghapus latar belakang, memperpanjang, menyinkronkan bibir dengan suara, atau mentransfer gerakan. list_voices dan list_characters membaca suara dan karakter Anda, get_generation_status mengikuti suatu pembuatan hingga URL akhirnya. Server ini mendukung revisi 2026-07-28 dari protokol tersebut sekaligus revisi handshake 2025: klien saat ini maupun klien di masa depan dapat terhubung tanpa pengaturan apa pun.
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.