Pruna AI P Image Ideogram API Documentation

Pruna AI P Image Ideogram API Documentation

Playground

Pruna P-Image Ideogram generates high-quality images from text prompts, including layout-driven visuals with accurately rendered text. It supports controllable levels of detail to balance speed and quality, along with 1K/2 K resolution, aspect ratio selection, and flexible output formats. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

P-Image-Ideogram Text-to-Image generates images from text prompts with selectable aspect ratio, resolution tier, reasoning effort, output format, and prompt upsampling. It is designed for fast image creation workflows where users need simple controls and predictable pricing across 1k and 2k outputs.

Why Choose This?

• Text-to-image generation
  Generate images directly from natural-language prompts.

• Flexible aspect ratios
  Choose from square, landscape, portrait, and common social media layouts.

• Resolution tiers
  Select 1k for lower-cost generation or 2k for higher-resolution output.

• Thinking level control
  Choose the reasoning effort used before image generation, from very low to very high.

• Prompt upsampling
  Expand the prompt before generation for additional detail when needed.

• Multiple output formats
  Generate images in png, jpeg, or webp format.

Parameters

How to Use

1. Write your prompt — Describe the image you want to generate.
2. Choose aspect ratio — Select the layout that matches your target format.
3. Choose resolution — Use 1k for lower-cost generation or 2k for higher-resolution output.
4. Set thinking level — Select the reasoning effort used before image generation.
5. Choose output format — Select png, jpeg, or webp.
6. Submit — Generate the final image and retrieve the output URL.

Pricing

Pricing depends on selected resolution and thinking.

Best Use Cases

• Prompt-based image generation — Create images directly from text prompts.
• Marketing visuals — Generate campaign images, social graphics, and promotional assets.
• Concept exploration — Quickly test visual ideas, styles, layouts, and creative directions.
• Design drafts — Create early-stage visuals before moving into final design production.
• Layout-specific images — Generate square, portrait, and landscape images for different use cases.

Related Models

• P-Image Edit — Edit images with prompt-guided instructions.
• P-Video Image-to-Video — Generate video from an input image and prompt.
• P-Video Animate — Animate images or visual inputs into motion-based video outputs.

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": "1:1",
  "resolution": "1k",
  "thinking": "high",
  "output_format": "jpeg",
  "prompt_upsampling": true
}
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/ideogram" \
  -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="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 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|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters