Koleksiyon Blueprint’i

KURV bugün Base Sepolia ve Solana Devnet üzerinde çalışıyor. Bu sayfa, eksiksiz bir üretimden (HANI the Dog, 1,000 parça, 20 benzersiz) çıkarılmış saha rehberidir ve https://mcp.kurv.fun/mcp adresindeki KURV bağlayıcısı üzerinden bir yapay zekâ ajanıyla çalışan bir yaratıcı için yazılmıştır. Bağlayıcı aynı rehberi ajanlara kurv://blueprint kaynağı olarak sunar ve doğru bilginin kaynağı kurv_builder_spec aracıdır: bu sayfa ile araç farklı bir şey söylediğinde araca güvenin.

Bir ajan bağlayın

1. OAuth ile uzak MCP’yi destekleyen bir istemciye https://mcp.kurv.fun/mcp adresini uzak MCP sunucusu olarak ekleyin. MCP ile bir ajan bağlayın istemcileri ve adımlarını listeler.
2. Tarayıcıda KURV’a giriş yapın ve bağlantıyı onaylayın. Bağlantının neler yapabileceğini (yalnızca okuma; okuma ve taslaklar; ya da okuma, taslaklar ve başlatmayı hazırlama) ve ne kadar süreceğini siz seçersiniz.
3. Ajandan önce kurv://blueprint okumasını, ardından ağınız için kurv_account ve kurv_builder_spec çağırmasını isteyin. Bağlayıcı ayrıca build-kurv-collection istemini sunar; bu istem, her onay durağını yerinde tutarak ajanı bu sayfa boyunca yürütür.

Kim ne yapar

Ajan planlar, doğrular, taslağı oluşturur, görselleri yükler, önizler ve başlatmayı hazırlar. Siz görselleri, örnekleri ve her uyarıyı onaylarsınız, ardından inceleme bağlantısını açar ve başlatmayı kendi cüzdanınızla imzalarsınız. Ajan asla dağıtım yapmaz, asla imzalamaz ve asla özel anahtar ya da kurtarma ifadesi istemez. Görseller bitip onaylandıktan sonra KURV tarafı (doğrulama, oluşturma, yükleme, önizleme, hazırlama) yaklaşık 20 dakika sürer. İyi görseller yapmak daha uzun sürer ve öyle de olmalıdır.

Sınırlar

Öğe	Sınır
Koleksiyon boyutu	Benzersizler dahil 1 ile 1,000 parça arası: 980 rastgele parça ve 20 benzersiz, 1,000 boyut eder.
Katmanlar	En fazla 12.
Özellik görselleri	Yalnızca benzersizlerin kullandığı görseller dahil, tüm katmanlarda toplam en fazla 240. Boş bir katmanın maliyeti yoktur.
Benzersizler	En fazla 32.
Kurallar	En fazla 48; her ağda aynıdır.
Görsel dosya boyutu	Tek tek gönderilen görsel başına en fazla 2 MiB; bir zip içindeki tek görsel için en fazla 20 MiB.
Tuval	Kare, en fazla 2,048 x 2,048 piksel. Her dosya tam olarak tuval boyutundadır.
Biçimler	Arka plan: PNG, JPEG ya da WebP. Diğer her katman: gerçek saydamlığı olan PNG.
None adı	Büyük ya da küçük harfle, her yazılışta ayrılmıştır. Asla None adlı bir özellik, asla boş bir görsel yok: bir katman noneWeight ile isteğe bağlı olur.
Açıklama	Zorunlu kabul edin: 1 ile 2,000 karakter arası. Her parçanın metadata’sına girer.
Taslaklar	Hesap başına 20 etkin taslak. kurv_archive_draft bir yeri hemen boşaltır; arşivlenen taslağın görselleri 30 gün saklanır, sonra silinir.
Önizlemeler	Çağrı başına en fazla 9 rastgele örnek ya da en fazla 9 seçilmiş parça numarası, 64 ile 512 piksel arasında.

Ajan her doğrulamadan sonra validCombinations değerini okur: katmanların ve kuralların izin verdiği farklı parça sayısı. Yaklaşık 50 milyon kombinasyona kadar olan alanlarda tam olarak sayılır, bunun üstünde tahmin olarak etiketlenir. Bu sayıyı koleksiyon boyutunun rahatça üstünde tutun.

Adım adım yol

Onay ile işaretlenen adımlar şu anlama gelir: ajan durur ve sizin açık evetinizi bekler.

1. Fotoğraflar. Gerçek evcil hayvanın ya da karakterin 3 ile 10 arası net fotoğrafını toplayın: yüz, gözler, dişler ve ağız, desenler, kulaklar. Yüzün üç çeyrek açıdan göründüğü bir ana fotoğraf seçin.
2. Sanat yönetimi. Tek bir stil, tek bir poz (en iyi üç çeyrek açı çalışır), tek bir kare tuval (2,048 x 2,048 önerilir) ve kısa bir stil sayfası: çizgi, gölgelendirme, palet, hava. Onay: herhangi bir özellik yapılmadan önce ana karakter.
3. Ana taban. Karakter, son pozunda, düz tek renkli bir arka plan üzerinde, ortalanmış, tam tuval boyutunda ve gerçek evcil hayvan olarak hemen tanınır halde. Her özellik bu ana görselin aynı poz, ölçek ve çerçeveyle yapılmış bir düzenlemesidir.
4. Katmanlar. Katmanlar aşağıdan yukarıya boyanır: Background, Skin (taban katmanı), Collar, Teeth, Eyes, Headwear (isteğe bağlı). Yaklaşık altı katman; koleksiyonu aksesuarlar değil karakter taşır. Ajan taban katmanını base_layer içinde adlandırır ve her katmana, özelliklerinin oturması gereken bir bağlantı kutusu verir.
5. Özellikler. Her özellik, ana görselin bir kopyası üzerinde yapılmış bir düzenlemedir; yalnızca özelliğin kendi pikselleri görünecek ve geri kalan her şey saydam olacak şekilde kesilir. Özellikleri gövdenin düz renkli bir kopyası üzerinde üretmek tüyleri onların dışında tutar. Konumu ya da ölçeği kayan bir özellik reddedilir.
6. Benzersizler. Tamamen dönüştürülmüş gövdeler (elmas, krom, lav, bronz); her biri uyumlu bir arka planla ve tasmasız. Görselleri, ağırlığı 0 olan bir özellik olarak kendi katmanına girer; böylece rastgele parçalarda asla görünmez; 240 görsele dahil sayılır.
7. Kurallar. Her derinin her tasma, diş, göz ve başlık özelliğiyle bir arada gösterildiği kontrol sayfaları. Her kötü eşleşme (iç içe geçen, görünmeyen, çirkin), nedenini söyleyen bir notla gruplanmış bir dışlama kuralı olur.
8. Onay: taslak oluşturulmadan önce katman sayfaları, en az 9 birleştirilmiş örnek, benzersizler sayfası, yapılandırma ve satış koşulları.
9. Yapılandırma ve doğrulama. Ağla birlikte kurv_builder_spec, ardından issues listesinde hiç hata kalmayana kadar yapılandırmayla kurv_validate_collection. Uyarılar, haberdar olmanız gereken şeyleri adlandırır. Yanıt; yüklenecek tam anahtarlar olan required_assets değerini ve validCombinations değerini taşır.
10. Taslak. version: 3, ağ, yapılandırma, satış koşulları ve bir idempotency anahtarıyla kurv_create_collection; önce check_only true olarak, sonra gerçekten. Başarısız bir çağrı aynı anahtarla yeniden gönderilir. Satış koşulları her ağda aynı biçimdedir: bkz. Satış koşulları.
11. Görseller. kurv_upload_trait ile tek tek (önce arka plan, taban ve her katmandan bir özellik, sonra bir önizleme, sonra geri kalanı) ya da kurv_upload_collection_zip ile web klasör biçiminde tek seferde. Boş bir katman bir noneWeight olur, asla saydam bir PNG değil.
12. Kontrol ve önizleme. Taslakla kurv_validate_collection görsel kontrollerini çalıştırır. Son yüklemeden sonra 9 örnekle kurv_preview_collection, artı her benzersizin parça numaraları ve en riskli kombinasyonlar. Ajan her görsele bakar. Uzun süren ilk önizleme retry_after ve bekleyen örneklerle yanıt verir; ajan yeniden çağırır.
13. Yeni taslak olmadan düzeltmeler. kurv_update_collection kuralları, benzersizleri, ağırlıkları, ipuçlarını ya da açıklamayı yerinde değiştirir; tuval değişemez. kurv_replace_trait_image bir görseli değiştirir, kurv_rename_trait bir özelliği yeniden adlandırır ve kurallarını ve benzersizlerini günceller, kurv_delete_trait hiçbir şeyin başvurmadığı bir özelliği kaldırır. Ardından yeni bir önizleme.
14. Onay: size okunan son örnekler ve her uyarı.
15. Hazırlama. Taslakla kurv_prepare_launch. warnings_need_review durumunda ajan her uyarıyı açıklar; ancak siz kabul ettikten sonra acknowledge_warnings true olarak yeniden çağırır. Bir tarayıcı bağlantısı alırsınız.
16. Sen imzalarsın. Tek bağlantıyı aç, doldurulanları kontrol et, Yayımla ve başlat seç ve son adımda kendi cüzdanınla imzala. Her yanıt bir Geri uzaktadır. Hiçbir araç senin yerine imzalamaz.

Kurallar

Bir kural, iki katmanın özelliklerini birbirinden ayrı ya da birlikte tutar: {"type", "when", "target", "note"}; burada type değeri exclude ya da require olur ve when ile target her biri bir katmanı ve isteğe bağlı olarak bir özelliği adlandırır: tek bir ad ya da bir ad listesi. Özellik verilmemesi katmanın tamamı demektir ve when ile target farklı katmanlar olmalıdır. Anahtar trait olur: traits ile yazılmış bir kural, sessizce katmanın tamamına uygulanmak yerine doğru anahtar adı verilerek reddedilir. None yalnızca o katmanın 0’ın üstünde bir noneWeight değeri varsa boş bir katmanı temsil edebilir. 48’in altında kalmak için eşleşmeleri listelerde gruplayın: her deri grubu için, asla takmamaları gereken her tasmayı listeleyen tek bir kural.

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

Kurallar parçalara ulaşır: önizlemeyi ve yayınlanan dosyaları aynı motor üretir ve mintleme bu dosyaları dağıtır. Bir benzersiz, ignoreRules true olarak kuralları atlayabilir; benzersizlik yine de korunur.

Benzersizler

Benzersizler specials öğeleridir: bir ad, her katman özelliğiyle ya da None ile, isteğe bağlı sabitlenmiş bir parça numarası ve isteğe bağlı bir açıklama. Bir katmanı dışarıda bırakan benzersiz o katmanı rastgele alır ve doğrulama bunların hangi katmanlar olduğu konusunda uyarır. null reddedilir; var olmayan bir özellik adı da reddedilir.

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

İnsanların istediği görseller

• Emek verilmiş, özenli görseller. Düz, bulanık, belli ki makineyle üretilmiş bir görünüm yok.
• Güçlü arka planlar: cesur renkler ya da zengin sahneler. Bilinçli değilse mekân temalarından (şehirler, plajlar) kaçının.
• Üç çeyrek poz ve gerçek evcil hayvana tanınır bir benzerlik: desenler, göz rengi, kulak şekli.
• Karakterin gövdesine oturan, ana görselin şekli üzerine çizilmiş belirgin özellikler. Dişler ağza tam olarak uyar.
• Havada duran başlık yok. Şapkalar bir temas gölgesiyle başın üzerinde durur; büyük kulaklar siperliğin üstünden geçer.
• Giysiler hayvanlara genellikle kötü oturur. Tasmaları, zincirleri ve boyun aksesuarlarını tercih edin ve onları her derinin üzerinde kontrol edin.
• Değerli benzersizler tamamen dönüştürülmüştür; uyumlu arka planları vardır ve tasmaları yoktur.

Bağlayıcı görselleri geldikçe kontrol eder. Hatalar bir yüklemeyi reddeder: farklı bir tuval boyutu, arka planın üstünde saydamlığı olan bir PNG olmayan bir katman, görünür pikseli olmayan bir görsel. Uyarılar incelemeniz için geri gelir: bağlantı kutusunun dışında kalan bir özellik, katmanından farklı ölçekte bir özellik, tabanın piksel ızgarasından kaymış bir özellik, taban resmini tamamen ya da kısmen hâlâ taşıyan bir özellik, tuvalin tamamını kaplayan bir özellik. Bir uyarı yanlış olabilir: güneş gözlükleriyle aynı katmandaki doğal gözler bilerek farklı boyuttadır. Ajan o katmanda mixedScales değerini ya da siz kabul ettiğinizde özellikte acknowledge değerini ayarlar ve görseller olması gerektiği gibi kalır.

Ajanın geri okudukları

Doğrulama yapan her araç, her sorunu tek seferde tek bir issues listesinde yanıtlar; her birinin bir yolu, bir kodu, bir önem derecesi, bir mesajı ve bir çözümü vardır. Bilinmeyen bir anahtar, en yakın geçerli anahtar belirtilerek adıyla reddedilir. Ağ adlandırılır (base-sepolia, solana-devnet, solana-localnet) ve ağ belirtmeyen bir taslak Base Sepolia’yı kullanır ve bunu söyler. Satış yöntemleri web sitesindeki adları kullanır (fixed, mystery, rising, falling, auction): bağlayıcı üzerinden Base sabit, gizemli ve artan fiyatı, Solana sabit ve artan fiyatı sunar; azalan fiyatlı ve açık artırmalı satışlar web sitesinde kurulur. Ağda olmayan bir satış alanı, örneğin Solana’da sembol, adıyla reddedilir. Metadata otomatik bir kontrolle kanıtlanır: her parça kurallara uyar, bir benzersiz sabitlendiği parçaya düşer ve boş bir katman {"trait_type": "<layer>", "value": "None"} olarak yazılır.

Bitmiş parçalar

Zaten bitmiş görseller olarak var olan parçalar katmanları atlar: önce kurv_finished_art_limits, ardından her görsel ve metadata.json için kurv_upload_finished_file_part, ardından kurv_import_finished_collection. Baytlar, animasyon dahil verildiği gibi saklanır ve katmanlı sınırlar uygulanmaz; web sitesinin güncel yayın sınırları uygulanır. Dosyaları Bitmiş görseller sayfası açıklar.

Bu sürümün bilinen sınırları

• Sürüm 2 bir Solana satışının değerleri, anahtarlardan sonra uygulamanın kendi ayrıştırıcısı tarafından tek tek kontrol edilir; sürüm 3 bir satış her sorunu tek seferde yanıtlar.
• Bitmiş görsellerden oluşan bir taslak yerinde düzenlenemez; düzeltme, yeni bir yükleme ve yeni bir anahtar demektir.
• Arşivlenen bir taslak bağlayıcı üzerinden geri yüklenemez; görselleri 30 gün saklanır.
• Robinhood Chain bağlayıcı üzerinden kullanılamaz: ağ yapılandırması ve satış şeması yok. Base ve Solana başlatmalarından sonra gelecek.

Koleksiyon sayıları anlık görüntülerdir ve bir başlatma kendi ağında gerçek değer taşır; birine para konusunda tavsiye vermeden önce Riskler ve sorumluluk reddi sayfasını okuyun.