{
  "catalog_version": "2026-09-26.1",
  "updated": "2026-09-26",
  "base_url": "https://dashboard.alphanetplus.com",
  "aspects": [
    {
      "value": "1:1",
      "size": "1024 × 1024"
    },
    {
      "value": "3:4",
      "size": "768 × 1024"
    },
    {
      "value": "4:3",
      "size": "1024 × 768"
    },
    {
      "value": "2:3",
      "size": "768 × 1152"
    },
    {
      "value": "3:2",
      "size": "1152 × 768"
    },
    {
      "value": "16:9",
      "size": "1344 × 768"
    },
    {
      "value": "9:16",
      "size": "768 × 1344"
    }
  ],
  "flow": [
    {
      "step": 1,
      "method": "POST",
      "path": "/v1/flux/uploads",
      "title": "Open an upload ticket",
      "detail": "One ticket per reference image. The response carries the URL to PUT the bytes to, the file id you submit, and the byte ceiling."
    },
    {
      "step": 2,
      "method": "PUT",
      "path": "{upload_url}",
      "title": "Upload the bytes",
      "detail": "Send the file itself to the signed URL, with the headers from the ticket. Nothing else goes through our API: the bytes go straight to storage."
    },
    {
      "step": 3,
      "method": "POST",
      "path": "/v1/tasks/alphanet-flux",
      "title": "Submit the task",
      "detail": "The model id and the file ids in order. Always send an Idempotency-Key: the same key and body return the same task, a different body under the same key is refused with 409."
    },
    {
      "step": 4,
      "method": "GET",
      "path": "/v1/tasks/{task_id}",
      "title": "Poll, then fetch the result",
      "detail": "Poll until the status is terminal, then read /v1/tasks/{task_id}/result for the signed URLs and the sha256 of each artifact."
    }
  ],
  "model": {
    "id": "makeup-quality",
    "label": "Virtual makeup",
    "summary": "Applies a named makeup look to a face, optionally matched from a reference photo.",
    "capability": "tool_makeup",
    "inputs": {
      "min": 1,
      "max": 2,
      "slots": [
        "portrait",
        "makeup reference (optional)"
      ]
    },
    "params": [
      {
        "name": "look",
        "type": "string",
        "values": "daily | korean | glam | bridal | latte | retro",
        "default": "daily",
        "note": "A fixed recipe of base, contour, brows, eyeshadow, liner, lashes and lip."
      },
      {
        "name": "intensity",
        "type": "string",
        "values": "light | medium | strong",
        "default": "medium"
      },
      {
        "name": "aspect",
        "type": "string",
        "values": "1:1 | 3:4 | 4:3 | 2:3 | 3:2 | 16:9 | 9:16",
        "note": "Optional. Omitted, the output follows the portrait’s shape (fallback 1:1)."
      },
      {
        "name": "seed",
        "type": "integer"
      }
    ],
    "refuses": [
      "prompt",
      "width",
      "height",
      "num_inference_steps",
      "max_sequence_length",
      "output_format",
      "output_quality"
    ],
    "output": "PNG shaped like the portrait. Identity, expression, hair, clothing, framing and lighting are asked to stay as they are.",
    "latency": "~62 s of inference (measured 2026-09-25)",
    "limits": [
      "A look is a recipe, not a brand shade: use it to compare directions, not to promise an exact product.",
      "The palette is matched to this person’s undertone and the original lighting, so the same reference gives a different result on another photo."
    ],
    "submit_body_example": {
      "model": "makeup-quality",
      "image_ids": [
        "<portrait_file_id>"
      ],
      "look": "korean",
      "intensity": "medium"
    },
    "price": "$0.01 per call",
    "try_it": "/virtual-makeup",
    "cases": [
      "makeup-korean",
      "makeup-glam-ref"
    ],
    "verified": "2026-09-25 (public gateway, 8/8)"
  }
}