BFL modelsimage generation api

bfl/flux-1/pulid

Name: Flux 1 Pulid
Author: BFL

Flux 1 Pulid by BFL - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Input

Prompt(string)

The prompt to generate an image from.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of image to use for inpainting.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Seed(integer)

The same seed and the same prompt given to the same version of the model will output the same image every time.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbfl/flux-1/pulid

Input Schema

4 parameters · 1 required · 3 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The prompt to generate an image from.
`seed`	integer	Optional	The same seed and the same prompt given to the same version of the model will output the same image every time.
`image`	string	Optional	URL of image to use for inpainting.
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "bfl/flux-1/pulid",
  "image": "https://static.sandbase.ai/examples/bfl/flux-1/pulid/input_reference_image_url_0.png",
  "prompt": "a woman holding sign with glowing green text 'PuLID for FLUX'"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Flux 1 Pulid

API README

Flux 1 Pulid

Flux 1 Pulid is an identity-preserving FLUX.1 portrait workflow built around PuLID conditioning. It uses a supplied face or person reference to anchor recognizable facial characteristics while allowing the prompt to change pose, clothing, background, lighting, camera treatment, and artistic style in the newly generated image.

Use it for character sheets, campaign portraits, profile variations, and creative scenes where the same person must remain visually recognizable. Select a clear reference with unobstructed facial detail, then describe the new composition independently; the identity reference defines who appears, while the prompt defines where they are, what they are doing, and how the image should look.

Highlights

Facial identity preservation. Carries recognizable facial structure and appearance from the supplied person reference.
New-scene portrait generation. Places the anchored identity into different poses, settings, clothing, and compositions.
Style-flexible identity control. Maintains who the subject is across photographic and illustrative treatments.
Reference-prompt separation. Uses the face reference for identity while written direction controls the rest of the visual scene.

Pricing

Configuration	Billing unit	Price
Base generation	Per request	$0.03

When to Use

✅ Good fit	❌ Consider alternatives
The project needs this exact generation or editing route	The intended task belongs to video, audio, or 3D media
Available references match every required local field	Required source assets or rights are unavailable
The brief can specify composition, color, and finish	Output must be deterministic at pixel level
Supported dimensions and formats fit final placement	Delivery requires unsupported canvas specifications
An asynchronous generated image fits production	A live frame-synchronous response is mandatory

Prompt Guide

Write a complete visual brief: identify the subject and references, define composition and viewpoint, describe lighting, palette, materials, typography, and finish, then list exact preservation constraints. FLUX.2 Klein does not rely on prompt upsampling, so use clear descriptive sentences rather than sparse keywords.

{
  "prompt": "A photorealistic editorial composition with precise subject placement, controlled lighting, exact colors, and clean typography",
  "seed": 1,
  "image": "https://example.com/reference.jpg",
  "aspect_ratio": "21:9"
}

Technical Specs

Spec	Value
Model ID	`bfl/flux-1/pulid`
Input fields	`seed` (integer)<br>`image` (string)<br>`prompt` (string)<br>`aspect_ratio` (string; `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`)
Required input	`prompt`
Output fields	`url`, `content_type`
Execution	Asynchronous job

Related Models

bfl/flux-1/krea/redux
bfl/flux-1/lora
bfl/flux-1/schnell