Inicio rápido

1. Crea una API key. En cloud.pictulab.com ve a Developers → API Keys y genera una key. Solo se muestra completa una vez: guárdala.

   Nota

   El acceso a la API está disponible desde el plan Starter.

2. Guárdala en una variable de entorno.

   export PICTULAB_API_KEY="pk_live_..."

3. Comprueba el coste (no consume tokens).

   curl "https://api.beta.pictulab.com/v1/pricing/image?model_id=gemini-2.5-flash-image&resolution=1K&aspectRatio=1:1" \
     -H "Authorization: Bearer $PICTULAB_API_KEY"

4. Genera tu primera imagen.

   cURL

   curl https://api.beta.pictulab.com/v1/generate/image \
     -H "Authorization: Bearer $PICTULAB_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "prompt": "Foto producto fondo blanco, estilo Amazon",
       "model_id": "gemini-2.5-flash-image",
       "aspectRatio": "1:1",
       "resolution": "1K"
     }'

   Node.js

   const res = await fetch('https://api.beta.pictulab.com/v1/generate/image', {
     method: 'POST',
     headers: {
       Authorization: `Bearer ${process.env.PICTULAB_API_KEY}`,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       prompt: 'Foto producto fondo blanco, estilo Amazon',
       model_id: 'gemini-2.5-flash-image',
       aspectRatio: '1:1',
       resolution: '1K',
     }),
   });
   
   const data = await res.json();
   console.log(data.images[0].url);

   Python

   import os
   import requests
   
   res = requests.post(
       "https://api.beta.pictulab.com/v1/generate/image",
       headers={"Authorization": f"Bearer {os.environ['PICTULAB_API_KEY']}"},
       json={
           "prompt": "Foto producto fondo blanco, estilo Amazon",
           "model_id": "gemini-2.5-flash-image",
           "aspectRatio": "1:1",
           "resolution": "1K",
       },
   )
   
   print(res.json()["images"][0]["url"])

5. Para lotes, usa jobs asíncronos con POST /v2/jobs y recibe el resultado por webhook.