Referans · Kaynaklar

Photta API kaynak endpoint'leri her üretimin ihtiyaç duyduğu id'ler

Tek cümlede

Kaynak endpoint'leri bir üretim çağrısının aldığı id'leri döndürür: mankenler, pozlar, arka planlar, ayakkabılar, kıyafet nitelikleri ve marka etiketleri, artı hesap bakiyeniz ve kullanımınız. Listeleme ücretsizdir.

API anahtarı alın Dokümantasyonu okuyun

Kaynak endpoint'leri: 13 kaynak endpoint'i
Kimlik doğrulama: Bearer anahtarı
Sınırlar: 600 istek/dk

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi 2026-09-10

Her kaynak endpoint'i, onu okuyan çağrıyla birlikte

Her bölüm, bu id'leri kullanan yeteneğe bağlantı verir.

GET/api/v1/mannequins

Mankenler

Kıyafet try-on için mevcut modelleri listeler: Photta'nın sistem mankenleri, kendi yüklemeleriniz ve manken üretim API'si ile oluşturduklarınız. Hesabınıza özel kalan özel bir manken yüklemek için aynı yola POST gönderin. İlgili id, try-on çağrısında `mannequin_id` içine girer.

curl https://api.photta.app/api/v1/mannequins \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/mannequins", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/mannequins",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Sanal try-on API'si

POST/api/v1/mannequins/jewelry

Mücevher mankenleri

Mücevher try-on için yakın çekim bir model fotoğrafı yükler. Mücevher çalışmaları boyun, kulak, bilek veya el üzerinde çerçevelendiğinden, tam vücut kıyafet seti yerine kendi manken setini kullanır.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
  "jewelry_type": "necklace",
  "gender": "female",
  "name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
    "jewelry_type": "necklace",
    "gender": "female",
    "name": "Emma"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/jewelry",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
      "jewelry_type": "necklace",
      "gender": "female",
      "name": "Emma"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Takı try-on API'si

GET/api/v1/poses

Pozlar

Bir try-on'ın talep edebileceği, kategoriye ve uygun oldukları ürün türüne göre filtrelenebilen pozları listeler. Id'yi `pose_id` olarak iletin; boş bırakırsanız API kıyafete uyan bir poz seçer.

curl https://api.photta.app/api/v1/poses \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/poses", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/poses",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Sanal try-on API'si

GET/api/v1/garment-attributes

Kıyafet uzunluğu ve kalıbı

Kıyafet try-on özelliğinin kabul ettiği uzunluk ve kalıp anahtarlarını döndürür. Aynı gömleğin bir katalog genelinde aynı şekilde işlenmesi için serbest metin açıklaması değil, anahtarı gönderin.

curl https://api.photta.app/api/v1/garment-attributes \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/garment-attributes",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Sanal try-on API'si

GET/api/v1/backgrounds

Arka planlar

Kıyafet try-on için sistem arka planlarını ve kendi yüklemelerinizi imleç tabanlı sayfalamayla listeler. Özel bir arka plan yüklemek için aynı yola POST gönderin; hesabınıza özel kalır.

curl https://api.photta.app/api/v1/backgrounds \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/backgrounds",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Gözlük sanal try-on API'si

POST/api/v1/brand-labels

Marka etiketleri

Hayalet manken çalışmaları için yeniden kullanılabilir bir etiket görseli yükler ve hem tekil işlerde hem de toplu işlemlerde `brand_label_id` olarak ilettiğiniz bir id döndürür. GET kayıtlı olanları listeler; DELETE, hesap sınırına ulaştığınızda bir tanesini kaldırır.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "@/path/to/pribrand-label.png",
  "name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "file": "@/path/to/pribrand-label.png",
    "name": "Pribrand Collar Label"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/brand-labels",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "file": "@/path/to/pribrand-label.png",
      "name": "Pribrand Collar Label"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Hayalet manken API'si

GET/api/v1/footwear

Ayakkabılar

Kıyafet try-on için türe ve cinsiyete göre filtrelenebilen, imleç tabanlı sayfalamaya sahip ayakkabı seçeneklerini listeler. Kıyafeti giyen aynı modele ayakkabı giydirmek için kullanın.

curl https://api.photta.app/api/v1/footwear \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/footwear", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/footwear",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Sanal try-on API'si

GET/api/v1/account

Hesap

Kaynağına göre ayrılmış kredi bakiyenizi, mevcut planınızı ve bir sonraki kredi yenilenmesini döndürür. Yetersizliği 402 ile keşfetmek yerine büyük bir toplu işlem öncesinde okuyun.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Workflows API

GET/api/v1/account/usage

Kullanım

Mevcut takvim ayı faturalandırma dönemi için başarılı ve başarısız işler olarak ayrılmış üretim sayıları ve kredi harcaması. Kendi istek çeteleniz yerine grafiğe dökülecek endpoint budur.

curl https://api.photta.app/api/v1/account/usage \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account/usage", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account/usage",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Toplu hayalet manken API'si

Kaynak endpoint'leri hakkında sorular

Kaynak endpoint'leri ne işe yarar?

Üretim çağrılarının aldığı id'leri (manken, poz, arka plan, marka etiketi) ve hesap durumunuzu döndürürler. Bu gruptaki hiçbir şey bir görsel oluşturmaz.

Kaynak çağrıları kredi harcar mı?

Hayır. Listeleme ücretsizdir ve bu gruptaki yüklemeler de (özel manken, arka plan, marka etiketi) ücretsizdir. Yalnızca üretimler için ödeme yaparsınız.

Uzun bir listede nasıl sayfalama yaparım?

Liste endpoint'leri bir limit ve bir imleç alır: gördüğünüz son id'yi `starting_after` olarak iletin ve sonraki sayfayı okuyun. Her istekte yeniden listelemek yerine aldıklarınızı önbelleğe alın.

Kendi mankenlerimi ve arka planlarımı yükleyebilir miyim?

Evet. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` ve POST `/api/v1/brand-labels` çağrılarının tümü kendi görsellerinizi kabul eder ve yüklediğiniz her şey hesabınıza özeldir.

Bu id'lerin kullanıldığı yerler

Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi 2026-09-10

API'yi beş dakikada deneyin

Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.

Bir hesap oluşturun ve API anahtarı alın API

13 kaynak endpoint'i
Bearer anahtarı
600 istek/dk