Emilia AI Studio — Riferimento API

Autenticazione

Tutte le richieste API devono includere la tua chiave API personale come Bearer token nell'header Authorization. Genera o ruota la chiave in Il mio account → Integrazioni.

Authorization: Bearer YOUR_API_KEY

POST /ai-image-render

POST https://ai.emilia.digital/it/wp-json/emai/v1/ai-image-render

Genera una singola immagine AI a partire da una foto prodotto sorgente.

Header

Parametri del body

Modalità (categorie)

Ogni modalità sblocca un insieme diverso di stili e campi helper.

Stili per modalità

Passa l'ID dello stile tramite il campo preset. Gli stili derivano dalla configurazione degli helper: ogni ID di stile qui sotto è valido per la modalità indicata.

Proporzioni

Da passare tramite il campo aspect. Predefinito: 1:1.

Risoluzioni e costo in crediti

Da passare tramite il campo resolution. Predefinito: 1K.

Helper di stile (opzioni per stile)

Ogni stile accetta un insieme aggiuntivo di campi di regolazione fine. Aggiungili come chiavi di primo livello nel body della richiesta. Gli helper non presenti nell'elenco dello stile scelto vengono ignorati.

Formato della risposta

Fatto! — 200 OK

{
  "ok": true,
  "data_url": "https://cdn.emilia.digital/.../generated.jpg",
  "s3": {
    "item": {
      "public_id": "abc123",
      "display_url": "https://cdn.emilia.digital/.../generated.jpg"
    }
  },
  "firstTry": false,
  "credits_available": null
}

data_url è l'URL CDN canonico dell'immagine generata: salvalo dal tuo lato.

Errore

{
  "code": "no_credits",
  "message": "no_credits",
  "data": { "status": 402 }
}

Errori

Esempi completi

cURL — richiesta minima

curl -X POST 'https://ai.emilia.digital/it/wp-json/emai/v1/ai-image-render' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "product",
    "preset": "pure_white",
    "aspect": "1:1",
    "resolution": "1K",
    "image_data_url": "https://example.com/my-product.jpg"
  }'

cURL — con helper (gioiello su modella)

curl -X POST 'https://ai.emilia.digital/it/wp-json/emai/v1/ai-image-render' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "jewelry",
    "preset": "on_model",
    "aspect": "4:5",
    "resolution": "2K",
    "model": "gemini",
    "image_data_url": "https://example.com/ring.jpg",
    "jewelry_gender": "female",
    "jewelry_skin_tone": "medium",
    "jewelry_body_part": "finger",
    "jewelry_model_background": "soft_focus_environment"
  }'

Node.js (fetch)

const res = await fetch('https://ai.emilia.digital/it/wp-json/emai/v1/ai-image-render', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.EMILIA_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    mode: 'food',
    preset: 'top_view',
    aspect: '1:1',
    resolution: '1K',
    image_data_url: 'https://example.com/dish.jpg',
    food_background: 'marble',
    food_style: 'realistic'
  })
});

const json = await res.json();
console.log(json.data_url);

PHP

$response = wp_remote_post('https://ai.emilia.digital/it/wp-json/emai/v1/ai-image-render', [
    'timeout' => 120,
    'headers' => [
        'Authorization' => 'Bearer ' . EMILIA_API_KEY,
        'Content-Type'  => 'application/json',
    ],
    'body' => wp_json_encode([
        'mode'           => 'clothing',
        'preset'         => 'studio_model',
        'aspect'         => '4:5',
        'resolution'     => '2K',
        'image_data_url' => 'https://example.com/shirt.jpg',
        'garment_view'   => 'front',
        'garment_fit'    => 'true_to_size',
        'background_type'=> 'seamless_paper',
        'bg_color'       => '#FFFFFF',
    ]),
]);

$body = json_decode(wp_remote_retrieve_body($response), true);
echo $body['data_url'];