API ve MCP sunucusu
Bir API anahtarıyla Claude, Cursor ya da kendi betiklerinizden üretin: aynı modeller, aynı krediler, başarısızlıklar iade edilir.
Tuvalin dışındaki Imaginode
Tuvalin üretebildiği her şey dışarıdan da erişilebilir: bir REST API ve bir MCP sunucusu (Model Context Protocol), bir yapay zekâ ajanının ya da bir betiğin sizin hesabınızla görsel ve video üretmesini sağlar. Çağrılar bakiyenizdeki kredileri, tuvaldeki fiyatlarla harcar; başarısız kalan üretim ise her zamanki gibi otomatik iade edilir.
MCP, yapay zekâ asistanlarının (Claude, Cursor ve daha birçoğu) dış araçları kullanmasını sağlayan standarttır. Imaginode bağlandıktan sonra asistanınız sohbetin ortasında bir görsel üretebilir, yazdığı yazıyı resimleyebilir ya da otomatik bir iş akışının görsellerini hazırlayabilir.
API anahtarı oluşturma
Profilinize gidin, “API anahtarları” bölümünü açın. Anahtara bir ad verin (“Claude Code”, “blog betiği”...) ve oluşturun: imk_… gizli değeri yalnızca bir kez görünür, hemen kopyalayın. En fazla beş etkin anahtar tutabilir, hepsini tek tıkla iptal edebilirsiniz; iptal edilen anahtar anında çalışmayı bırakır.
Oluşturmak için doğrulanmış bir e-posta gerekir ve her anahtar dakikada 10 üretimle sınırlıdır: rahatça çalışmaya yeter, bir ajan çığırından çıksa bile kazara bakiyeyi boşaltmaya yetmez.
MCP sunucusunu bağlama
Sunucu adresi https://imaginode.ai/api/mcp (Streamable HTTP taşıması). Kimlik doğrulaması için anahtarınızı “Authorization: Bearer imk_…” başlığında gönderin. Claude Code'da tek bir komut yeter: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer anahtariniz". Claude.ai ya da Cursor'da aynı adres ve aynı başlıkla özel bir bağlayıcı ekleyin.
Dört araç sunuluyor. list_models katalogu ve kredi cinsinden fiyatları verir. generate_image bir görsel oluşturur ve sonucu bekler: URL doğrudan döner. generate_video bir video başlatır ve takip kimliği döndürür. get_generation_status bir üretimi son URL'ye kadar izler.
Doğrudan REST API
Betikleriniz için üç uç nokta yeterli. GET /api/models modelleri, seçeneklerini ve fiyatlarını kimlik doğrulaması olmadan listeler. POST /api/generate bir üretim başlatır: model, prompt ve modelin seçeneklerini (duration, resolution, aspectRatio, audio, imageUrls) içeren bir JSON, anahtar Authorization başlığında, yanıtta ise requestId, cost ve yeni bakiyeniz döner. GET /api/generate/status?requestId=… önce running, sonra çıktı URL'leriyle completed ya da iadeyle birlikte failed döndürür.
Girdi görselleri (imageUrls) Imaginode hesabınızda barındırılan medya olmalı: önce medyanıza aktarın ya da önceki bir üretimin URL'sini yeniden kullanın.
İyi alışkanlıklar
Promptlarınızı doğrulamak için ekonomik bir modelle başlayın (Flux Schnell, 1 kredi), premium modellere sonra geçin. Videoda durumu 30 saniyede bir sorgulayın: genelde 1 ila 5 dakika, uzun üretimlerde 30 dakikaya kadar sürer. Kesin maliyet, sonuçtan bile önce, başlatma anında döner.
Anahtar bir sırdır: depoya commit etmeyin, kimseyle paylaşmayın. En ufak şüphede profilinizden iptal edip yenisini oluşturun.