POST https://api-design.prosecaptain.com/api/generate

Przykład: packshot studyjny

{
  "productImage": { "data": "<base64>", "mimeType": "image/png" },
  "sceneType": "product_packshot",
  "packshotStyle": "studio",
  "studioBackgroundColor": "white",
  "studioCameraDistance": "medium",
  "aspectRatio": "1:1",
  "imageSize": "2K"
}

Przykład: zdjęcie lifestyle

{
  "productImage": { "data": "<base64>", "mimeType": "image/jpeg" },
  "sceneType": "product_packshot",
  "packshotStyle": "auto",
  "location": "home",
  "people": "with_people",
  "prompt": "Butelka na stoliku w jasnym salonie, poranne światło",
  "aspectRatio": "4:5"
}

Przykład: szablon Twojej marki

{
  "productImage": { "data": "<base64>", "mimeType": "image/jpeg" },
  "sceneType": "product_packshot",
  "template": "3f2b9c1e-8a4d-4c2e-9b1f-5d6e7a8b9c0d",
  "aspectRatio": "4:5"
}

Styl, światło i obrazy wzorcowe pochodzą z szablonu. Więcej w Szablony.

Parametry

PoleOpis
productImageZdjęcie produktu: { data, mimeType }, data w base64. Maksymalnie 10 MB. mimeType jest wymagany.
sceneTypeproduct_packshot (packshot i lifestyle), mockup, action, abstract, linear.
packshotStylestudio dla packshotu studyjnego, auto dla zdjęcia lifestyle.
promptDodatkowy opis sceny, maksymalnie 5000 znaków.
aspectRatioauto (domyślnie), 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 5:4, 4:5, 21:9, 9:21.
imageSize1K, 2K, 4K. Działa, gdy aspectRatio nie jest auto.
studioBackgroundColorauto, white, off_white, light_gray, mid_gray, black, beige, pastel_blue, pastel_pink, pastel_green, custom.
studioBackgroundHexKolor tła przy custom, np. #F5F5F5.
studioCameraDistanceauto, extreme_close_up, close_up, medium_close_up, medium, medium_wide, wide.
locationMiejsce dla lifestyle: office, home, outdoor, cafe, studio, urban, nature, industrial, minimal, luxury, albo custom + customLocation.
peoplewithout_people (domyślnie) albo with_people. Dodatkowo peopleGender, peopleAge, peopleCount, peopleEthnicity, peopleInteraction.
dimensionPlacementUstawienie produktu: auto, on_ground, on_surface, on_pedestal, floating.
dimensionsEnabled, dimensionWidth, dimensionHeight, dimensionDepthWymiary produktu w cm, żeby zachować skalę.
referenceImagesObrazy referencyjne stylu: tablica { data, mimeType }.
imageStylephoto, illustration, infographic, icon.
templateIdentyfikator szablonu: UUID szablonu Twojej marki albo szablon infografiki (flat, isometric i inne). Listę zwraca GET /api/templates.
designSessionIdKontynuacja sesji: kolejne wersje tego samego obrazu.

Wymagane jest zdjęcie produktu, szablon albo prompt.

Odpowiedź

{
  "success": true,
  "image": "<base64>",
  "mimeType": "image/jpeg",
  "filename": "image-1766172464378-c2158164.jpeg",
  "id": "b1e2…",
  "designSessionId": "5b0f…",
  "iterationIndex": 1,
  "directus": {
    "url": "https://api.paqshot.com/assets/54c4528c-…"
  },
  "credits": 29
}
  • image: gotowy obraz w base64.
  • directus.url: stały adres obrazu w Twojej bibliotece.
  • designSessionId: przekaż w kolejnym wywołaniu, żeby poprawiać ten sam obraz.
  • credits: liczba obrazów w planie przed tym wywołaniem.