Geliştiriciler · API

Her ürünü modele giydir
tek bir API çağrısıyla.

NoShot uygulamasının arkasındaki motor, sade bir REST API olarak. Bir ürün görseli gönder; saniyeler içinde, katalog ölçeğinde fotogerçekçi model render’ları ve temiz maskeler geri al.

Sunucu: api.noshot.co
Çağrı: POST /v1/generate
canlı: 200 OK · 4 render · 4K + maske

API anahtarını al Hızlı başlangıcı gör

<15s

görsel başına

temiz maske

uç nokta

500+

marka üretimde

Neden API

Üretim kalitesinde görsel, bir uç nokta olarak

Uygulamanın yaptığı her şey; derleme hattından, PIM’den ya da vitrinden çağrılabilir — yükleme ekranı yok, elle sanat yönetimi yok.

Programatik model görselleri

Tek bir POST, düz ürün fotoğrafını fotogerçekçi model render’larına çevirir. Modeli, pozu, ışığı ve sahneyi tıklayarak değil, parametre olarak seç.

Katalog ölçeğinde toplu üretim

Binlerce ürünü /v1/batch üzerinden tek istekte geçir. Aynı krediler, takip edilecek tek iş — pazar yeri ölçeğine göre tasarlandı.

4K çıktı, temiz maskeler

Her render 4K’ya kadar çözünürlükte ve piksel hassasiyetinde alfa maskesiyle gelir — doğrudan kurguya ya da ürün sayfasına hazır.

Polling değil, webhook

job.succeeded olayına abone ol; görseller hazır olduğu an bitmiş URL’leri uç noktana POST edelim. Boş döngü yok.

Hızlı başlangıç

Tek istekte ilk render’ın

Bearer token ile kimlik doğrula, model ve sahne parametreleriyle bir ürün görseli gönder, ardından işi sorgula ya da webhook’u yakala. İşte tüm turun.

İstek

cURLPOST /v1/generate

curl -X POST https://api.noshot.co/v1/generate \
  -H "Authorization: Bearer $NOSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://cdn.yourbrand.com/sku/8842-front.jpg",
    "category": "apparel",
    "model": { "gender": "female", "body": "medium", "skin_tone": "III" },
    "scene": { "preset": "studio-daylight", "background": "seamless-bone" },
    "output": { "count": 4, "resolution": "4k", "mask": true }
  }'

NodePOST /v1/generate

import NoShot from "@noshot/sdk";

const noshot = new NoShot({ apiKey: process.env.NOSHOT_API_KEY });

const job = await noshot.generate({
  productImageUrl: "https://cdn.yourbrand.com/sku/8842-front.jpg",
  category: "apparel",
  model: { gender: "female", body: "medium", skinTone: "III" },
  scene: { preset: "studio-daylight", background: "seamless-bone" },
  output: { count: 4, resolution: "4k", mask: true },
});

console.log(job.id, job.status); // "job_9f8c2a1b7d", "succeeded"

PythonPOST /v1/generate

import os
from noshot import NoShot

noshot = NoShot(api_key=os.environ["NOSHOT_API_KEY"])

job = noshot.generate(
    product_image_url="https://cdn.yourbrand.com/sku/8842-front.jpg",
    category="apparel",
    model={"gender": "female", "body": "medium", "skin_tone": "III"},
    scene={"preset": "studio-daylight", "background": "seamless-bone"},
    output={"count": 4, "resolution": "4k", "mask": True},
)

print(job.id, job.status)  # "job_9f8c2a1b7d", "succeeded"

Yanıt

JSON200 OK

{
  "id": "job_9f8c2a1b7d",
  "status": "succeeded",
  "credits_used": 4,
  "images": [
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01-mask.png"
    },
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02-mask.png"
    }
  ],
  "created_at": "2026-07-22T09:41:20Z"
}

Örnek amaçlıdır — tüm parametreler ve her sahne hazır ayarı için uygulamadaki canlı referansa bak.

Tek çağrı, iki uç

İpek abiye — Verev kesim fildişi ipek, boncuk işlemeli yaka — Girdiİpek abiye

İpek abiye — Her boncuk koyduğun yerde — Çıktı3072 × 4096

Uç noktalar

Bilerek küçük bir yüzey

Dört uç nokta tüm yaşam döngüsünü kapsar — üret, kontrol et, topla, keşfet.

POST: /v1/generateTek bir ürün görseli ile model ve sahne parametrelerinden render işi oluştur.
GET: /v1/jobs/{id}Bir işin durumunu, görsel URL’lerini ve maske URL’lerini sorgula.
POST: /v1/batchKatalog ölçeğinde çalışmalar için tek istekte çok sayıda ürünü kuyruğa al.
GET: /v1/modelsKullanılabilir model hazır ayarlarını, vücut tiplerini, ten tonlarını ve sahneleri listele.

Kota & fiyatlandırma

Kredi tabanlı ve basit

Bir görsel bir kredidir — fiyatlandırma modelinin tamamı bu.

01: 1 görsel = 1 kredi. Bir istekteki ek render’lar aynı bakiyeden düşer.
02: Başarısız ya da reddedilen render’lar asla ücretlendirilmez.
03: Her yanıt bir X-Credits-Remaining başlığı döner; kullanımını kolayca ölçersin.
04: Kotalar planınla birlikte büyür; Enterprise’da tamamen kalkar.

PlanGörselKota

Free1030 istek/dk

Starter100 / ay60 istek/dk

StudioEn popüler400 / ay120 istek/dk

EnterpriseSınırsızÖzel

Krediler NoShot planından gelir — tüm paketleri fiyatlandırma sayfasında gör.

Paketleri & kredileri gör

Tam referans

Dokümantasyonun tamamı uygulamada

Her parametre, webhook olayı, hata kodu ve resmî SDK — sürümlenmiş ve etkileşimli — panelinde duruyor. Bir anahtar al, referans tam yanında açılsın.

API referansını aç

Model görsellerini
programatik olarak yayına al.

Ücretsiz başla Demo planla

Uygulamada bir anahtar oluştur, dakikalar içinde ilk çağrını yap. Ücretsiz katman dahil — kart yok.