API docs / Image models

portrait-series API

Create a series of portrait photos from a single image

Model id
flux-kontext-apps/portrait-series
Provider
flux-kontext-apps
Output
Image
Price
From 14 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "flux-kontext-apps/portrait-series". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "flux-kontext-apps/portrait-series",
  "input": {
    "reference_images": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
reference_imagesrequiredarray of URLs

Image of the person to create a series of photos for. Must be jpeg, png, gif, or webp.

Up to 1 files · Accepts image/*

output_countnumber

The number of poses to generate

Default: 1

Min 1 · Max 13

output_formatstring

Default: png

One of: jpg, png

backgroundstring

Default: white

One of: white, black, gray, green screen, neutral, original

randomize_imagesboolean

Whether to randomize the poses

Default: false