Emilia AI Studio — API Reference

Authentication

All API requests must include your personal API key as a Bearer token in the Authorization header. Generate or rotate your key under My Account → Integrations.

Authorization: Bearer YOUR_API_KEY

POST /ai-image-render

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

Generates a single AI image from a source product photo.

Headers

Body parameters

Modes (categories)

Each mode unlocks a different set of styles and helper fields.

Styles per mode

Pass the style ID via the preset field. Styles are derived from the helper configuration — each style ID below is valid for the indicated mode.

Aspect ratios

Pass via the aspect field. Default: 1:1.

Resolutions & credit cost

Pass via the resolution field. Default: 1K.

Style helpers (per-style options)

Each style accepts an additional set of fine-tuning fields. Add these as top-level keys in the request body. Helpers not in the chosen style's list are ignored.

Response format

Success — 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 is the canonical CDN URL of your generated image — store this on your end.

Error

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

Errors

Full examples

cURL — minimal request

curl -X POST 'https://ai.emilia.digital/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 — with helpers (jewelry on model)

curl -X POST 'https://ai.emilia.digital/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/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/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'];