Skip to main content
The Porn Factory AI API is a JSON-over-HTTPS API rooted at:
All requests require Authorization: Bearer pfai_.... Generation submissions also require Content-Type: application/json and an Idempotency-Key header.

Authentication

Create scoped keys and store one-time secrets safely.

Request lifecycle

Understand idempotency, polling, and terminal statuses.

​
Versioning

The current contract is v1. Backward-compatible fields may be added without changing the version. Breaking request or response changes will use a new API version.

​
Timestamps and IDs

  • Timestamps are ISO 8601 strings in UTC.
  • API request IDs begin with req_.
  • API keys begin with pfai_.
  • Webhook secrets begin with whsec_.
  • Generated-library source IDs are UUIDs owned by the authenticated account.

​
Public data boundary

The API returns only fields needed to select a catalog entry, budget and submit a generation, and retrieve its result. It does not return account user IDs, private media locations, model file locations, provider details, infrastructure metadata, internal registry state, prompts from other users, or moderation evidence. Catalog IDs are opaque public selectors. Do not infer storage, provider, or routing behavior from them, and do not depend on their format beyond what the reference documents.