Imágenes
Anuncios estáticos
Anuncios para el feed de Facebook a partir de una foto
- Desde
- 10 crpor anuncio
- Endpoint
POST /api/v1/studio/estaticos/runs- Id del flujo
estaticos
Resultados reales de este flujo.
La solicitud
# 0. Sube antes tu archivo. Su id va en el cuerpo.
MEDIA_ID=$(curl -s -X POST https://staglight.ai/api/v1/uploads \
-H "Authorization: Bearer $STAGLIGHT_API_KEY" -F file=@product.jpg | jq -r .id)
# 1. Pide el precio. Gratis, no se cobra nada.
PRICE=$(curl -s -X POST https://staglight.ai/api/v1/studio/estaticos/estimate \
-H "Authorization: Bearer $STAGLIGHT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"card": "price_slash",
"media": {
"product": ["'"$MEDIA_ID"'"]
}
}' | jq .credits)
echo "$PRICE"
# 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
START=$(curl -s -X POST https://staglight.ai/api/v1/studio/estaticos/runs \
-H "Authorization: Bearer $STAGLIGHT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"card": "price_slash",
"media": {
"product": ["'"$MEDIA_ID"'"]
},
"max_credits": '"$PRICE"'
}')
ID=$(echo "$START" | jq -r .id)
# 3. Espera a que termine.
while :; do
STATUS=$(curl -s "https://staglight.ai/api/v1/studio/estaticos/runs/$ID" -H "Authorization: Bearer $STAGLIGHT_API_KEY" | jq -r .status)
case "$STATUS" in succeeded|partial|failed) break ;; esac; sleep 10
done
# 4. Descarga todos los archivos en un zip.
curl -s -L -o result.zip "https://staglight.ai/api/v1/studio/estaticos/runs/$ID/outputs.zip" -H "Authorization: Bearer $STAGLIGHT_API_KEY" import os, time, uuid, requests
BASE = "https://staglight.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['STAGLIGHT_API_KEY']}"}
# 0. Sube antes tu archivo. Su id va en el cuerpo.
with open("product.jpg", "rb") as f:
media_id = requests.post(f"{BASE}/api/v1/uploads", headers=HEADERS, files={"file": f},
timeout=300).json()["id"]
# 1. Pide el precio. Gratis, no se cobra nada.
estimate = {
"card": "price_slash",
"media": {
"product": [media_id]
}
}
price = requests.post(f"{BASE}/api/v1/studio/estaticos/estimate", headers=HEADERS, json=estimate, timeout=60).json()["credits"]
print(price)
# 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
body = {
"card": "price_slash",
"media": {
"product": [media_id]
},
"max_credits": 18
}
body["max_credits"] = price
r = requests.post(f"{BASE}/api/v1/studio/estaticos/runs", json=body, timeout=60,
headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())})
r.raise_for_status()
start = r.json()
# 3. Espera a que termine.
while True:
run = requests.get(f"{BASE}/api/v1/studio/estaticos/runs/{start['id']}", headers=HEADERS, timeout=60).json()
if run["status"] in ("succeeded", "partial", "failed"):
break
time.sleep(10)
# 4. Descarga todos los archivos en un zip.
with open("result.zip", "wb") as out:
out.write(requests.get(f"{BASE}/api/v1/studio/estaticos/runs/{start['id']}/outputs.zip", headers=HEADERS, timeout=300).content) // Node 18 o posterior. Guárdalo como run.mjs: el await de nivel superior necesita un módulo.
const BASE = "https://staglight.ai";
const headers = { Authorization: `Bearer ${process.env.STAGLIGHT_API_KEY}` };
const json = { ...headers, "Content-Type": "application/json" };
// 0. Sube antes tu archivo. Su id va en el cuerpo.
import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("file", new Blob([await readFile("product.jpg")]), "product.jpg");
const { id: mediaId } = await (await fetch(`${BASE}/api/v1/uploads`, { method: "POST", headers, body: form })).json();
// 1. Pide el precio. Gratis, no se cobra nada.
const estimate = {
"card": "price_slash",
"media": {
"product": [mediaId]
}
};
const price = await (await fetch(`${BASE}/api/v1/studio/estaticos/estimate`, { method: "POST", headers: json, body: JSON.stringify(estimate) })).json();
console.log(price.credits);
// 2. Inícialo. max_credits rechaza lo que pase de ese precio; el Idempotency-Key evita un cobro doble.
const body = {
"card": "price_slash",
"media": {
"product": [mediaId]
},
"max_credits": 18
};
body.max_credits = price.credits;
const res = await fetch(`${BASE}/api/v1/studio/estaticos/runs`, {
method: "POST", headers: { ...json, "Idempotency-Key": crypto.randomUUID() }, body: JSON.stringify(body),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const start = await res.json();
// 3. Espera a que termine.
let run = start;
while (!["succeeded", "partial", "failed"].includes(run.status)) {
await new Promise((r) => setTimeout(r, 10000));
run = await (await fetch(`${BASE}/api/v1/studio/estaticos/runs/${start.id}`, { headers })).json();
}
// 4. Descarga todos los archivos en un zip.
console.log(`${BASE}/api/v1/studio/estaticos/runs/${start.id}/outputs.zip`); Usa la API de Staglight para ejecutar el flujo "Anuncios estáticos" desde código de servidor.
Docs: https://staglight.ai/es/llms.txt
Este flujo: https://staglight.ai/es/api/flujos/estaticos
Clave: léela de la variable de entorno STAGLIGHT_API_KEY. Nunca en código del navegador.
1. Pide antes el precio, gratis: POST /api/v1/studio/estaticos/estimate
2. Inícialo: POST /api/v1/studio/estaticos/runs, con la cabecera Idempotency-Key y max_credits.
Cuerpo: {"card": "price_slash", "media": {"product": ["med_your_upload_id"]}, "max_credits": 18}
Los archivos son ids de POST /api/v1/uploads.
3. Si se agota el tiempo, mira la lista de trabajos antes de reintentar, y reintenta con el mismo Idempotency-Key.
4. Consulta la ejecución hasta que termine y descarga su outputs.zip. Cuánto cuesta
| Plantilla | Final, mejor texto | Borrador, rápido y barato |
|---|---|---|
| Precio tachado: oferta llamativa | 18 cr | 10 cr |
| Editorial / artículo de prensa | 18 cr | 10 cr |
| Reseña de 1 estrella con giro | 18 cr | 10 cr |
| La IA lo recomienda | 18 cr | 10 cr |
| Última hora | 18 cr | 10 cr |
| No compres esto | 18 cr | 10 cr |
| Conversación por DM | 18 cr | 10 cr |
| La verdad sobre… | 18 cr | 10 cr |
| Escrito en el brazo | 18 cr | 10 cr |
| Tus formatos | 18 cr | 10 cr |
Precios del servidor con los ajustes por defecto. La llamada de estimación da el precio exacto para tus entradas, gratis.
Entradas
| Nombre | Tipo | Valores |
|---|---|---|
cardobligatorioLa plantilla | string | price_slash, editorial, review_twist, ai_answer, breaking_news, reverse_psych, dm_convo, truth_poster, arm_writing, custom |
media.productFoto del producto | media id[] | |
media.remixAnuncio existente | media id[] | |
inputs.resolutionResolución | enum | 1K, 2K, 4K |
inputs.languageIdioma | enum | auto, en, es, it, de, fr, nl, pl, ... |
inputs.headlineTitular, línea 1 | string | |
inputs.sublineTitular, línea 2 (en la banda) | string | |
inputs.line2_styleEstilo de la línea 2 | enum | banner, text |
inputs.currencyMoneda | enum | eur, usd, gbp, chf, kr, pln, czk, huf, ... |
inputs.old_pricePrecio anterior | string | |
inputs.new_pricePrecio nuevo | string | |
inputs.ratingValoración | string | |
inputs.hookGancho / enfoque (opcional) | string | |
inputs.subheadSubtítulo (opcional) | string | |
inputs.quoteLa reseña de tu cliente | string | |
inputs.chatMensajes reales (opcional) | string | |
inputs.proofPrueba social (opcional) | string | |
inputs.ad_labelMostrar la etiqueta «Anuncio» | bool | |
inputs.format_idFormato importado | string | |
inputs.audienceQuién lo compra (opcional) | string | |
inputs.workedQué te ha funcionado antes (opcional) | string | |
inputs.nicheNicho / categoría | string | |
inputs.urlSitio web | string | |
inputs.descriptionDescripción del producto y argumentos de venta | string | |
inputs.summaryLo que ha encontrado el análisis (editable) | string | |
qualityCalidad | enum | final, draft |
aspectFormato | enum | 1:1, 4:5, 9:16 |
Los archivos son ids de POST /api/v1/uploads. Ver la documentación
Pruébalo a mano
El mismo flujo funciona en el estudio, con el mismo saldo. Úsalo para ver el resultado antes de escribir código.
Más flujos
-
Resultado real Imágenes Estudio de imágenes de producto
Una foto de producto, un carrusel completo para tu tienda
por anuncio, desde10 cr
-
Resultado real Imágenes Fotos UGC
Fotos espontáneas con el producto en la mano, como hechas con el teléfono, a partir de una sola foto de producto. Sin texto, puro estilo UGC.
por anuncio, desde10 cr
-
Resultado real Imágenes Recrear
Sube esa foto que te habría encantado hacer y recibe una nueva y original con el mismo estilo. Si quieres, con tu producto.
por anuncio, desde18 cr