API per la fotografia di prodotti

Che cos'è un'API per la fotografia di prodotti?

Un'API per la fotografia di prodotto trasforma una semplice immagine di prodotto in uno scatto di marketing o di catalogo (un modello che tiene in mano o utilizza l'oggetto, ambientato sullo sfondo di uno studio, una scena di stile di vita o uno sfondo creativo descritto da un suggerimento) senza prenotare un servizio fotografico, uno studio o un modello.

Muapi lo espone tramite AI Product Photography, un singolo endpoint che accetta person_image_url, product_image_url e un prompt che descrive lo stile o l'impostazione e restituisce il risultato composito: una chiave API, un flusso di richiesta/sondaggio, prezzi con pagamento in base al consumo.

Fotografia del prodotto e prova virtuale

Questi sono intenti adiacenti ma distinti. La fotografia del prodotto compone un prodotto su una persona e inserisce entrambi in una nuova scena descritta da un prompt: l'obiettivo è uno scatto di marketing o di stile di vita, e lo sfondo e l'ambientazione sono guidati dal prompt. La prova virtuale scatta la foto di una persona esistente e la scambia con un capo diverso mantenendo la scena originale: l'obiettivo è una visualizzazione della vestibilità/aspetto di quella persona specifica. Utilizza la fotografia del prodotto per una foto di stile di vita di un prodotto con un modello; usa la prova virtuale quando devi mostrare come sta un capo su una persona precisa. Confronta con Prova virtuale →

Capacità chiave

Ottenere buoni input e risultati rapidi

• Utilizza una foto di una persona chiara e ben illuminata. Un singolo soggetto, una posa neutra e una buona illuminazione danno al modello il riferimento più pulito per comporre il prodotto in modo naturale.
• Isolare il prodotto. Un prodotto ripreso in modo pulito con uno sfondo minimo ingombro produce forme e trasferimenti di texture più accurati rispetto a un prodotto fotografato in una scena movimentata.
• Sii specifico nel prompt. Descrivi esplicitamente lo sfondo, l'illuminazione e l'atmosfera. Uno sfondo bianco da studio con luci soffuse e uno stile di vita all'aperto scattato all'ora d'oro producono risultati molto diversi dalle stesse due immagini di input.
• Aspettatevi qualche iterazione. Come ogni modello di immagine generativa, i risultati variano da esecuzione a esecuzione: tratta il primo output come una bozza ed eseguilo nuovamente con un prompt perfezionato o un'immagine sorgente più pulita se il composito sembra fuori posto.

Come chiamare l'API per la fotografia del prodotto

1. Ospita entrambe le immagini. Carica la foto della persona e la foto del prodotto tramite POST /api/v1/upload_file o utilizza qualsiasi URL raggiungibile pubblicamente.
2. Invia la richiesta. Chiama POST /api/v1/ai-product-photography con person_image_url, product_image_url e prompt.
3. Sondaggio per il completamento. Controlla GET /api/v1/predictions/{request_id}/result fino al completamento dello stato, quindi scarica l'immagine composita.

curl -X POST https://api.muapi.ai/api/v1/ai-product-photography \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "person_image_url": "https://example.com/model-photo.jpg",
    "product_image_url": "https://example.com/product-photo.jpg",
    "prompt": "Promoting brand in professional studio look"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-product-photography",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "person_image_url": "https://example.com/model-photo.jpg",
        "product_image_url": "https://example.com/product-photo.jpg",
        "prompt": "Promoting brand in professional studio look",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Domande frequenti