Kwaivgi Kling Image O3 Text To Image

Kwaivgi Kling Image O3 Text To Image

Playground

Kling O3 is Kuaishou’s advanced AI image generation model with support for 4K resolution, delivering ultra-high-quality visuals with exceptional detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Kling Image O3 is Kuaishou’s next-generation text-to-image model from the O3 architecture, delivering superior visual quality and creative expression from natural language prompts. Describe any scene, character, or concept — the model generates detailed, expressive images with flexible aspect ratios, resolution options, and batch generation support. Built-in Prompt Enhancer helps refine your descriptions for optimal results.

Why Choose This?

• O3-generation quality The latest architecture with improved detail, composition, and prompt understanding.

• High-fidelity generation Produces sharp, detailed images with strong composition and natural lighting.

• Flexible aspect ratios Multiple options including 1:1, 3:4, 4:3, 9:16, 16:9 and more to fit any use case.

• Resolution control Choose output resolution (1k and above) based on your quality and speed requirements.

• Batch generation Generate multiple images in a single request for rapid iteration and A/B testing.

• Prompt Enhancer Built-in tool to automatically improve your descriptions for richer, more detailed output.

Parameters

How to Use

1. Write your prompt — describe the scene, subject, style, lighting, and mood in detail.
2. Choose aspect ratio — select the format that fits your use case (3:4 for portraits, 16:9 for landscapes, etc.).
3. Set resolution — choose 1k for speed or higher for more detail.
4. Set num_images — generate multiple variations in one request if needed.
5. Choose output format — select png for lossless quality or jpeg for smaller file size.
6. Run — submit and download your images.

Pricing

Billing Rules

• Base rate: $0.028 per image (1K/2K)
• 4K rate: $0.056 per image (2× base)
• Total cost = num_images × per-image rate

Best Use Cases

• Concept Art & Illustration — Generate detailed visual concepts from text descriptions.
• Social Media Content — Create eye-catching images for posts, stories, and ads.
• Marketing & Branding — Produce on-brand visuals without photography.
• Storyboarding — Quickly visualize scenes and characters for creative projects.
• Product Visualization — Generate product concepts and mockups from descriptions.

Pro Tips

• Use the Prompt Enhancer to automatically refine vague descriptions into detailed prompts.
• Be specific about lighting, mood, and style for more predictable results.
• Generate multiple images (num_images > 1) to explore variations and pick the best.
• Match aspect ratio to your final use: 3:4 for portraits, 16:9 for banners, 9:16 for mobile.
• Use png format when you need transparency support or lossless quality.

Notes

• Prompt is the only required field.
• Higher resolution may slightly increase processing time.
• Ensure prompts comply with content guidelines.

Related Models

• Kling Image V3 Text-to-Image — Previous generation text-to-image model.
• Kling Video O3 Pro Text-to-Video — Generate videos from text prompts with O3 Pro quality.
• Kling Video O3 Pro Image-to-Video — Animate generated images into video.

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": "16:9",
  "resolution": "1k",
  "num_images": 1,
  "output_format": "png",
  "shot_type": "customize"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/kwaivgi/kling-image-o3/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