Skip to content

dsh-free-image

Verified

dsh-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/503 cevabı, istediği bekleme retry.budgetMs iç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 503 dö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