Idioma: ES
Empezar gratis

El estudio de fotos de producto, como API.

La API de Herofab recibe una foto de producto y el nombre de una herramienta y procesa el trabajo en segundo plano; la consulta del trabajo o un webhook firmado indica cuándo la imagen final está lista para descargar.

  • Claves de API Bearer
  • Webhooks firmados
  • Hasta 100 trabajos por lote
  • OpenAPI 3.1 y llms.txt

MCP https://app.herofab.app/mcpOpenAPI · GPT Actions https://app.herofab.app/api/agent/openapi.jsonMCP · API key https://app.herofab.app/mcp/studio

{
  "mcpServers": {
    "herofab-studio": {
      "type": "http",
      "url": "https://app.herofab.app/mcp/studio",
      "headers": {
        "Authorization": "Bearer hf_sk_live_..."
      }
    }
  }
}
curl https://app.herofab.app/api/v1/jobs -H "Authorization: Bearer $HEROFAB_API_KEY" -H "Idempotency-Key: $(uuidgen)" --json '{"tool": "ghost_mannequin", "inputs": {"garment": "ASSET_ID"}}'
Cómo funciona

De la foto a la imagen final.

01

Enviar

Subir la foto de producto y crear un trabajo con una herramienta y sus ajustes; el trabajo reserva sus créditos.

POST /api/v1/assetsPOST /api/v1/jobs

02

Consultar

Consultar el trabajo hasta que termine, o recibir un webhook firmado en ese momento.

GET /api/v1/jobs/{id}

03

Descargar

Obtener la imagen final con el ID de recurso de la salida del trabajo.

GET /api/v1/assets/{id}/content

Ejemplo completo: subir la foto, crear el trabajo, esperar, descargar
API=https://app.herofab.app/api/v1
AUTH="Authorization: Bearer $HEROFAB_API_KEY"

# 1 · Upload the product photo
ASSET_ID=$(curl -s "$API/assets" \
  -H "$AUTH" \
  -F file=@shirt.jpg | jq -r .id)

# 2 · Create the job
BODY=$(jq -n --arg garment "$ASSET_ID" '{tool: "ghost_mannequin",
  inputs: {garment: $garment}, params: {style: "3d", backdrop: "white"}}')
JOB_ID=$(curl -s "$API/jobs" \
  -H "$AUTH" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "$BODY" | jq -r .id)

# 3 · Poll until the job is finished
while :; do
  JOB=$(curl -s "$API/jobs/$JOB_ID" -H "$AUTH")
  STATE=$(jq -r .state <<<"$JOB")
  [ "$STATE" = queued ] || [ "$STATE" = running ] || break
  sleep 2
done
[ "$STATE" = succeeded ] || { jq -r .failure.code <<<"$JOB"; exit 1; }

# 4 · Download the image
OUTPUT_ID=$(jq -r '.outputs[0].asset_id' <<<"$JOB")
EXT=$(jq -r '.outputs[0].content_type | ltrimstr("image/")' <<<"$JOB")
curl -sL "$API/assets/$OUTPUT_ID/content" -H "$AUTH" -o "result.$EXT"
Primeros pasos

Su próxima colección, fotografiada esta semana.

20 créditos al registrarse, sin tarjeta. Las imágenes creadas con créditos gratuitos llevan marca de agua. Herofab también elimina la marca de agua de esas imágenes cuando se compran créditos.