About P-H3-Image
P-H3-Image is Pruna AI's still-image model, adapted from the MiniMax H3 open weights and released as open source in November 2026. It draws a picture from a written scene, or edits one using up to nine pictures, in five sizes from 1K to 4K and 15 aspect ratios.
Call it with the model name pruna-ai/p-h3-image/edit on POST /jobs/createTask, from $0.03.
Introduction
P-H3-Image Image Editing uses the first picture as its source and accepts up to eight additional reference images. A text instruction tells the model which elements to retain or replace.
Key features
Address the source as <Picture 1> and the next input as <Picture 2>. The default output shape follows the first picture; selecting aspect_ratio overrides it. All five resolution tiers are available for edits. In our tests one 4k edit returned 3360 x 5024 pixels.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 |
image_urls | Yes | Photos to edit or combine. Say in the prompt what each one adds. |
output_format | No | File type of the result. jpeg · png · webp · Default: jpeg |
prompt | Yes | Describe what you want to make. |
resolution | No | Choose an available output size. 1k · 1.5k · 2k · 3k · 4k · Default: 1k |
seed | No | Use the same seed and settings for more controlled comparisons. ≥ 0 · ≤ 2147483647 |
Pricing
Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per image |
|---|---|
| resolution 1K | $0.03 |
| resolution 1.5K | $0.048 |
| resolution 2K | $0.066 |
| resolution 3K | $0.138 |
| resolution 4K | $0.21 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
Use cases
Use one portrait for a new outfit and seaside setting, or combine a stage photograph with a replacement performer. Our single-source and two-source tests retained the requested identity through scene changes.
Prompt guide & pro tips
Place the scene to keep in the first slot, then say which details come from each numbered input. Reversing that order gave a result closer to the other scene in our tests. Pruna AI says lower resolutions can show more detail artifacts.
API quick start
Call the P-H3-Image API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
- Send the request. POST /jobs/createTask with model pruna-ai/p-h3-image/edit and an input object that follows the parameter table. The response returns a task ID straight away.
- 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": "pruna-ai/p-h3-image/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"
],
"resolution": "1k",
"output_format": "jpeg"
}
}'
# 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.
P-H3-Image API questions
How much does the P-H3-Image API cost?
P-H3-Image starts at $0.03 per image with Edit Image, its cheapest task. Prices by option: 1K $0.03 per image, 1.5K $0.048 per image, 2K $0.066 per image, 3K $0.138 per image. The API uses a separate USD balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What are the limits of the P-H3-Image · Edit Image API?
Resolutions: 1K · 1.5K · 2K · 3K · 4K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Reference images: 9; Prompt length (characters): 5,000; Largest upload: 10 MB. Requests outside these limits are rejected before anything is charged.
More about P-H3-Image
- Endpoints
- P-H3-Image · Create Image
