PopNowAPI Docs
Main content

Krea 3 API reference

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

Call Krea 3 from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in credits, and a request you can paste into a terminal.

At a glance

Made by
Krea
Output
Image
From
36 credits per image ($0.036)

1 credit = $0.001. A task holds the highest possible charge when it is accepted and settles the real amount when it finishes, rounded up to whole credits; failed tasks are not charged. Ask POST /api/v1/jobs/quote for the exact figure before you run.

Create Image

krea/3/text-to-image

Price

OptionCredits (per image)US dollars
Default36$0.036

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersDescribe the image in plain sentences.
aspect_ratioOptionalstring1:11:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9Output aspect ratio.
qualityOptionalstringhighhigh, fastHigh favours image quality; fast returns sooner. Same price.
enable_thinkingOptionalbooleanfalse—Spend longer planning the prompt before drawing. Same price.
negative_promptOptionalstring—up to 1,024 charactersWhat to keep out of the image. Used by the high-quality variant only.
output_formatOptionalstringpngpng, jpegFile format of the result.
seedOptionalinteger—0 to 2147483647Random seed. Reusing one does not guarantee an identical image.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "krea/3/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Edit Image

krea/3/edit

Price

OptionCredits (per image)US dollars
Default72$0.072

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersSay what to change and what stays the same. Refer to sources as image 1, image 2 and so on.
image_urlsRequiredarray<string (uri)>—up to 8 itemsOne to eight source images, in the order your prompt refers to them. Each one adds to the price.
aspect_ratioOptionalstring1:11:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9Output aspect ratio.
qualityOptionalstringhighhigh, fastHigh favours image quality; fast returns sooner. Same price.
enable_thinkingOptionalbooleanfalse—Spend longer planning the prompt before drawing. Same price.
negative_promptOptionalstring—up to 1,024 charactersWhat to keep out of the image. Used by the high-quality variant only.
output_formatOptionalstringpngpng, jpegFile format of the result.
seedOptionalinteger—0 to 2147483647Random seed. Reusing one does not guarantee an identical image.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_urls. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "krea/3/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ]
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Next steps

On this page