Emilia AI Studio — Referencia de la API

Autenticación

Todas las solicitudes de API deben incluir su clave de API personal como token Bearer en el encabezado Authorization. Genere o rote su clave en Mi cuenta → Integraciones.

Authorization: Bearer YOUR_API_KEY

POST /ai-image-render

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

Genera una única imagen de IA a partir de una foto de producto de origen.

Encabezados

Parámetros del cuerpo

Modos (categorías)

Cada modo desbloquea un conjunto diferente de estilos y campos auxiliares.

Estilos por modo

Pase el ID de estilo a través del campo preset. Los estilos se derivan de la configuración de ayuda; cada ID de estilo a continuación es válido para el modo indicado.

Relaciones de aspecto

Pase a través del campo aspect. Predeterminado: 1:1.

Resolutions & credit cost

Pase a través del campo resolution. Predeterminado: 1K.

Ayudas de estilo (opciones por estilo)

Cada estilo acepta un conjunto adicional de campos de ajuste fino. Añádalos como claves de nivel superior en el cuerpo de la solicitud. Las ayudas no incluidas en la lista del estilo elegido se ignoran.

Formato de respuesta

Éxito — 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 es la URL CDN canónica de su imagen generada; almacénela en su sistema.

Error

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

Errores

Ejemplos completos

cURL — solicitud mínima

curl -X POST 'https://ai.emilia.digital/es/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 auxiliares (joyería en modelo)

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