Quickstart - Porn Factory AI API

1

Create an API key

Sign in to Porn Factory AI and open the Developer tab. Create a key and save both one-time values: the pfai_ API key and the whsec_ webhook secret.

2

Find a checkpoint

Query the catalog for a generator-ready checkpoint.

curl --request GET \
  --url 'https://pornfactoryai.com/api/v1/models?mode=text_to_image&type=checkpoint&limit=20' \
  --header 'Authorization: Bearer pfai_YOUR_KEY'

Save the model_id and version_id from one result.

3

Submit a generation

Use a unique idempotency key for this logical request.

curl --request POST \
  --url 'https://pornfactoryai.com/api/v1/generations' \
  --header 'Authorization: Bearer pfai_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: tutorial-image-001' \
  --data '{
    "mode": "text_to_image",
    "prompt": "A cinematic portrait with warm window light",
    "seed_mode": "random",
    "checkpoint": {
      "model_id": "mdl_YOUR_MODEL",
      "version_id": "ver_YOUR_VERSION"
    },
    "loras": []
  }'

4

Poll the request

The submit response includes a stable request_id and poll_url. Poll until the status is COMPLETED or FAILED.

curl --request GET \
  --url 'https://pornfactoryai.com/api/v1/requests/req_YOUR_REQUEST' \
  --header 'Authorization: Bearer pfai_YOUR_KEY'

Retry a timed-out submit with the same Idempotency-Key and the exact same body. The API returns the original request instead of charging twice.

⌘I