BELGELER · API REFERANSI

API Referans

Uç noktalar, anahtarlar, sınırlar. AI resim uç noktaları için referans — oluştur, kaldır, genişlet — kimlik doğrulama, CORS ve hız sınırlamaları ile.

Morph, api.morph.cool adresinde AI destekli görüntü uç noktaları sunar. Bu uç noktalar Artboard'un AI özelliklerini destekler ve entegrasyonlar geliştiren geliştiriciler tarafından kullanılabilir.

Temel URL: https://api.morph.cool
Tüm istekler HTTPS kullanır. HTTP istekleri reddedilir.

Kimlik Doğrulama

AI görüntü uç noktaları (oluştur, kaldır, genişlet) temel kullanım için kimlik doğrulama gerektirmez. IP adresi üzerinden hız sınırlandırılır. Kullanıcı verilerini değiştirme uç noktaları (dönüştürmeler, zil, liderlik tablosu) Bearer token olarak Authorization başlığına geçirilen bir JWT belirteci gerektirir.

Authorization: Bearer <jwt_token>

Hız Sınırlamaları

Tüm uç noktalar, kötüye kullanım önlemek için hız sınırlandırılmıştır. Sınırı aşmak, JSON hata ile 429 durum kodunu döndürür.

Artboard AI uç noktaları — IP başına dakikada 10 istek (KV destekli).
Dönüştürme günlüğü — kimlik doğrulama gerektirir, ayrı IP sınırı yok.
Hata raporlama — IP başına dakikada 30 istek.
Beğeni Listesi — IP başına dakikada 10 istek.

Resim Oluştur

POST /artboard/generate

Metin-ile-imaj oluşturma ve inpainting. Bir maske ile seçilen bölgeleri metin isteği temelinde doldurmak için bir canvas görüntüsü gönderin. Ayrıca, görüntü hakkında bir metin açıklaması döndüren bir 'açıklama modu' da destekler.

Alan	Tip	Açıklama
prompt	string	Üretilecek içerik için metin açıklaması. Açıklama modunda gerekli değildir.
canvasImagegerekli	string	Canvas içeriğinin Base64 kodlu PNG'si.
maskImage	string	Seçim maskesinin Base64 kodlu PNG'si. Beyaz = doldurulacak alan. İçerik doldurma için gerekli, tanımlama için gerekli değil.
mod	string	`"describe"` olarak ayarlayın görüntü açıklaması modu için. Üretim için atlayın.

Üretim yanıtı:

{
  "result": "<base64_png_string>"
}

Cevabı tanımla:

{
  "result": "A detailed text description of the image content."
}

Doğrulama: Açıklama modunda, PNG en az 64×64 piksel olmalıdır. Daha küçük resimler REGION_TOO_SMALL hatası döndürür.

Nesne Kaldır

POST /artboard/remove

AI destekli nesne kaldırma. Maskede bir nesneyi çizip model, alanı bağlamına uygun içerikle doldurur.

Alan	Tip	Açıklama
canvasImagegerekli	string	Canvas'in Base64 kodlu PNG'si.
maskImagerequired	string	Base64 kodlu PNG maskesi. Beyaz = kaldırılacak alan.

Cevap:

{
  "result": "<base64_png_string>"
}

Üretici Genişletme

POST /artboard/expand

Belirli bir yönde tuvali genişletin. Yapay zeka, yeni alanı mevcut görüntüyle eşleşen içerikle doldurur. Bağlantı piksel uzatması için bağlam kullanır.

Alan	Tip	Açıklama
canvasImagegerekli	string	Canvas'ın Base64 kodlu PNG'si. Her kenar 64–4096px olmalıdır.
yöngerekli	string	Bir tanesi: `left`, `right`, `top`, `bottom`, `all`.
expandPxgerekli	number	Genişletmek için pikseller. Aralık: 64–512.
prompt	string	Oluşturulan içeriği yönlendirmek için isteğe bağlı metin isteği.

Cevap:

{
  "result": "<base64_png_string>"
}

Doğrulama: Kaynak görüntü her iki kenarında da 64–4096px olmalıdır. Genişletilmiş pano herhangi bir boyutta 4096px'i aşmamalıdır. İhlaller REGION_TOO_SMALL veya CANVAS_TOO_LARGE hataları döndürür.

Hata Yanıtları

Tüm uç noktalar, error alanı olan JSON hata yanıtları döndürür:

{
  "error": "RATE_LIMITED"
}

Sık karşılaşılan hata kodları:

İŞLEM_SAYISI_AŞIMI — çok fazla istek. Bekleyip tekrar deneyin.
ALAN_YETERSIZ — resim boyutları minimum 64×64 piksele göre aşağıda.
CANVAS_TOO_LARGE — genişletilmiş canvas 4096px sınırını aşıyor.
MISSING_FIELDS — gerekli bir alan sağlanmadı.

Notlar

AI modeli — tüm inpainting uç noktaları Cloudflare Workers AI üzerinden Stable Diffusion v1.5 kullanır. İlerleme adımları 20'ye kadar sınırlandırılmıştır.
Resim formatı — tüm resimler base64 kodlu PNG olmalıdır.
Gizlilik — resimler bellekte işlenir ve saklanmaz, kaydedilmez veya model eğitimi için kullanılmaz.
CORS — uç noktalar, morph.cool, www.morph.cool ve localhost:5173 adreslerinden gelen istekleri kabul eder.
Zaman aşımı — istemci 30 saniyelik bir zaman aşımı ayarlamalıdır. Sunucu tarafı işleme nadiren 15 saniyeyi aşar.

Morph'u Aç