Krea 3 API

About Krea 3

Krea's newest model, with a step that plans the picture first.

Call it with the model name krea/3/edit on POST /jobs/createTask, from 11 credits per image ($0.11).

Introduction

Krea 3 Image editing changes or combines one to eight source images from a plain-language instruction. Krea built Krea 3 for edits first: say what should change and what should stay, and refer to the sources as image 1, image 2 and so on. You set the output shape; every result is about one megapixel.

Choose a mode by starting material

Key features

Combine people, clothes and places

Up to eight sources in one request. In our example the woman from image 1 wears the paisley dress from image 2 on a canyon deck, with her face and hair kept.

Name sources by number

"The person from image 2" picks the second upload: in our check with a woman as image 1 and a man as image 2, only the man appeared.

Identity holds through big changes

A woman in an office blazer became a 1970s portrait in a wood-panelled den with the same face, braids and framing.

Fashion-level content only

Requests and sources are screened.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 11 credits per image ($0.11).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Virtual try-on and styling

A portrait plus a product photo of a garment becomes a styled shot of that person wearing it.

Restaging and period looks

Move a subject into a new location, era or light while keeping who they are.

Prompt guide & pro tips

Lead with the change

Start with what should change, then one sentence on what stays. For several sources, name each one: "the woman from image 1", "the dress from image 2".

Pick the output shape

The result uses the aspect ratio you choose rather than the source's shape. Match the ratio to the main photo to avoid unwanted cropping.

Mind the source count

State the age of people when you change their era or styling; looks can drift younger or older.

API quick start

Call the Krea 3 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model krea/3/edit and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "krea/3/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "1:1",
    "quality": "high",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Krea 3 API questions

More about Krea 3

Try it

Krea 3 AI Image Generator onlineCreate images with Krea 3 in PopNow

Endpoints

Krea 3 · Create Image

Docs

Krea 3 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Krea 3 results without polling