Pruna AI P Image Text To Image API Documentation

Pruna AI P Image Text To Image API Documentation

Playground

Pruna AI P-Image Text to Image is a fast AI image generation model that creates high-quality images from text prompts. Ready-to-use REST inference API for creative design, marketing visuals, concept art, social media content, product mockups, and image generation workflows with simple integration, no coldstarts, and affordable pricing.

Features

Pruna AI P-Image Text-to-Image generates images from natural-language prompts with flexible size controls, custom aspect ratios, and reproducible outputs through seed support. It is suitable for portraits, product visuals, concept art, marketing creatives, and other prompt-driven image generation workflows.

Why Choose This?

• Prompt-based image generation Turn natural-language descriptions into polished images for creative and commercial use.

• Flexible aspect ratio control Use preset aspect ratios or switch to custom for direct width and height control.

• Custom image dimensions Set width and height to better match delivery requirements for web, social, ads, and design workflows.

• Multiple output formats Export generated images as png or other supported formats depending on your workflow.

• Seed support for reproducibility Use seed to reproduce results more consistently across generations.

• Affordable fixed pricing Generate images at a simple flat cost per run.

Parameters

How to Use

1. Write your prompt — describe the subject, style, lighting, composition, and mood you want.
2. Choose aspect ratio — use a preset ratio or select custom if you want direct control over width and height.
3. Set width and height (optional) — these only take effect when aspect_ratio is set to custom.
4. Choose output format — select the format that best fits your workflow.
5. Set a seed (optional) — use a fixed seed for more reproducible generations.
6. Submit — run the model and download the generated image.

Example Prompt

A clean studio portrait of an adult US female model against a soft beige background, natural makeup, elegant neutral outfit, calm confident expression, soft diffused studio lighting, premium commercial photography, photorealistic, ultra-detailed, refined composition

Pricing

Just $0.005 per image.

Best Use Cases

• Portrait generation — Create polished studio-style or lifestyle portraits from prompts.
• Marketing creatives — Generate ad visuals, banners, and campaign assets quickly.
• Product concept imagery — Produce mockups and clean commercial scenes from text instructions.
• Social media content — Create prompt-driven visuals sized for posts, stories, and promotional content.
• Concept art and ideation — Explore visual directions rapidly with prompt and seed control.
• Custom-size image generation — Match output dimensions to specific design or publishing requirements.

Pro Tips

• Be specific in your prompt about subject, style, lighting, background, and mood.
• Use custom aspect ratio when you need exact width and height for a delivery format.
• Keep the same seed when you want to iterate on a concept with more consistent outputs.
• Use png when image quality matters more than file size.
• Start with smaller dimensions for rapid testing, then refine once the prompt direction is working.
• Short, focused prompts often give more controllable results than overly long descriptions.

Notes

• prompt is the only required field.
• width and height only take effect when aspect_ratio is set to custom.
• seed helps with reproducibility but may not guarantee identical results in every case.
• Pricing is fixed at $0.005 per image.

Related Models

• Other Pruna AI image generation and image editing models may be useful when you need different quality, speed, or workflow trade-offs.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "custom",
  "width": 512,
  "height": 512,
  "output_format": "png",
  "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/pruna-ai/p-image/text-to-image" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters