dsh-free-image
Verifieddsh-free-image · v0.1.0 · MIT
Keyless image generation for DeepSeek Harness
Install
dsh plugin add dsh-free-image Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-free-image
DeepSeek Harness için anahtarsız görsel üretimi.
dsh-free-image, DSH ajanına API anahtarı ve ücretli hesap gerektirmeyen bir
generate_image aracı verir. Sağlayıcı, prompt için görsel baytları döndüren bir
HTTP GET uç noktasından ibarettir; yani eklenti ücretsiz genel bir uç noktayla
kutudan çıktığı gibi çalışır, ayarı değiştirerek kendi sunucuna yönlendirebilirsin.
Ücretsiz uç noktalar IP başına hız sınırlıdır. Bu yüzden eklenti aynı anda tek istek çalıştırır, uç noktanın "N saniye sonra tekrar dene" cevabını sınırlı bir bütçe içinde bekler ve körlemesine hata vermek yerine kalan bekleme süresini söyler.
Araçlar
| Araç | Tür | Ne yapar |
|---|---|---|
generate_image |
tek dosya yazar | Prompt'tan tek görsel üretir, ayarlı dizine kaydeder; mutlak yolu, gerçek piksel boyutunu ve bayt boyutunu döner. |
list_image_models |
salt-okunur | Ayarlı sağlayıcıları listeler: uç nokta, model, boyut sınırları, hız, zaman aşımı, çıktı dizini. |
Nasıl çalışır
prompt ──▶ GET <baseUrl>/<url-encoded prompt>?width=…&height=…&nologo=true
◀── görsel baytları
<output.dir>/<YYYYMMDD-HHMMSS>-<slug>.<ext> olarak kaydedilir
- Hiçbir anahtar saklanmaz/gönderilmez; istekte yalnızca prompt ve boyut vardır.
- Yanıt
image/*olarak doğrulanmadan hiçbir şey yazılmaz. output.maxBytesüstündeki görseller yazılmaz, reddedilir.402/429/503cevabı, istediği beklemeretry.budgetMsiçindeyse tekrar denenir; sığmıyorsa araç bekleme süresini raporlar.
Kurulum
dsh plugin --profile web add dsh-free-image
systemctl restart dsh-web # veya DSH sürecinizi yeniden başlatın
Ayar gerekmez: varsayılan sağlayıcı anahtarsız genel uç noktadır. Uç noktayı, boyut sınırlarını veya çıktı dizinini değiştirmek için:
- id: free-image
config:
providers:
- id: pollinations
label: Pollinations (keyless)
baseUrl: https://image.pollinations.ai/prompt
model: ''
maxWidth: 1024
maxHeight: 1024
rateLimitMs: 45000
timeoutMs: 120000
defaults:
provider: pollinations
width: 512
height: 512
output:
dir: /root/work/generated/images
maxBytes: 10485760
retry:
budgetMs: 90000
maxAttempts: 3
Ayarlar
| Anahtar | Varsayılan | Anlamı |
|---|---|---|
providers[].id |
— | Araçların kullandığı sağlayıcı kimliği. |
providers[].baseUrl |
https://image.pollinations.ai/prompt |
Prompt uç noktası; kodlanmış prompt son yol parçası olarak eklenir. |
providers[].model |
'' |
İsteğe bağlı model sorgu parametresi. |
providers[].maxWidth / maxHeight |
1024 |
Bu sağlayıcıdan istenebilecek en büyük boyut. |
providers[].rateLimitMs |
45000 |
Bildirilen hız; modele raporlanır. |
providers[].timeoutMs |
120000 |
İstek başına HTTP zaman aşımı. |
defaults.provider |
ilk sağlayıcı | Çağrı sağlayıcı belirtmezse kullanılan. |
defaults.width / height |
512 |
Varsayılan görsel boyutu. |
output.dir |
<DSH_HOME>/generated/images |
Görsellerin yazıldığı dizin. |
output.maxBytes |
10485760 |
Eklentinin yazacağı en büyük görsel. |
retry.budgetMs |
90000 |
Bir çağrının hız sınırının geçmesini bekleyebileceği süre. |
retry.maxAttempts |
3 |
Çağrı başına toplam HTTP denemesi. |
Kendi sunucun
Aynı eklenti, prompt'u URL yolunda kabul edip görsel baytı döndüren yerel bir
üretim sunucusuyla da çalışır — örneğin önüne koyduğun bir Automatic1111/ComfyUI
arayüzü. baseUrl'i ona çevir; orada da anahtar gerekmez. Bu, genel ücretsiz uç
noktaya gizlilik dostu alternatiftir: prompt'lar makineden çıkmaz ve 45 saniyelik
hız sınırı olmaz.
Dürüst sınırlar
- Genel ücretsiz uç noktalar hız sınırlıdır (yazım sırasında IP başına ~45 sn'de 1
görsel), zaman zaman
503döner ve koşullarını değiştirebilir. - Görsel kalitesi, uç noktanın varsayılan modelinin ne ürettiğiyse odur.
- Prompt uç noktaya gönderilir; özel bir şey için genel uç nokta kullanma.
Gereksinimler
- DSH
>= 0.2.1-rc.4(Node^22.19.0 || >=24.0.0). - Ayarlı uç noktaya giden HTTPS erişimi.
Geliştirme
npm run link-peers # yerel dsh kurulumundan @deepseek-ai peer paketlerini linkler
node --test
Lisans
MIT