Qwen Image Edit 2509 Multiple Angles API Documentation

Qwen Image Edit 2509 Multiple Angles API Documentation

Playground

Qwen Image Edit 2509 Multiple Angles is an AI image editing model that generates multiple-angle views of objects or scenes from a single image. Transform perspectives and create diverse viewpoints with text prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Qwen Image Edit 2509 Multiple Angles generates new camera perspectives of a subject from reference images. Control horizontal rotation, vertical tilt, and camera distance to create realistic multi-angle views — perfect for product photography and 3D visualization without reshooting.

Why Choose This?

• Multi-angle generation Create new camera perspectives from up to 3 reference images.

• Precise horizontal rotation Rotate the viewpoint in 5 positions: -90 (left), -45, 0 (front), 45, 90 (right).

• Vertical tilt control Adjust camera elevation: -30 (low angle), 0 (eye level), 30 (elevated), 60 (high angle).

• Camera distance Control zoom level: 0 = close-up, 1 = medium shot, 2 = wide shot.

• Optional prompt guidance Add text descriptions to refine the generated perspective.

Parameters

Angle Reference

Horizontal Angle (horizontal_angle):

• -90 → left side view
• -45 → rotate left 45 degrees
• 0 → front view
• 45 → rotate right 45 degrees
• 90 → right side view

Vertical Angle (vertical_angle):

• -30 → low angle (looking up)
• 0 → eye level
• 30 → elevated view
• 60 → high angle (looking down)

Distance:

• 0 → close-up
• 1 → medium shot
• 2 → wide shot

How to Use

1. Upload your images — provide 1-3 reference images.
2. Set horizontal angle — choose the horizontal rotation.
3. Set vertical angle (optional) — adjust camera elevation.
4. Set distance (optional) — choose close-up, medium, or wide shot.
5. Add prompt (optional) — describe any additional guidance.
6. Run — submit and download the new perspective.

Pricing

Best Use Cases

• Product Photography — Generate multiple product angles from a few reference shots.
• E-commerce — Produce multi-angle product listings without reshooting.
• 3D Visualization — Preview objects from different perspectives.
• Sports & Action — Create alternate viewing angles of action scenes.
• Creative Exploration — Experiment with camera angles and compositions.

Pro Tips

• Use multiple reference images from different angles for more accurate results.
• Combine horizontal rotation with vertical tilt for dynamic camera positions.
• Use distance 0 for detail shots, distance 2 for full-body or environment context.
• Values are rounded to the nearest valid angle automatically.
• Keep seed consistent to compare different angle settings on the same subject.

Notes

• Images is the only required field; maximum 3 reference images.
• Angle values are rounded to the nearest valid position.
• enable_base64_output and enable_sync_mode are API-only parameters.
• Ensure uploaded image URLs are publicly accessible.
• Seed value -1 generates a random seed each time.

Related Models

• Qwen Image Max Edit — Bilingual image editing with multi-image support.
• Qwen Image Max Text-to-Image — Generate images from text descriptions.

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'
{
  "images": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
  ],
  "horizontal_angle": 0,
  "vertical_angle": 0,
  "distance": 1,
  "output_format": "jpeg"
}
JSON
)

# 1. Submit the prediction once. Never retry this request automatically:
# a retry after an unclear failure can create a second, billed task.
CHECK='The task may already exist. Check History or the predictions list before submitting again.'
if ! SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/qwen-image/edit-2509-multiple-angles" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"); then
  printf 'Submit failed. %s\n' "${CHECK}" >&2
  exit 1
fi

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. %s\n' "${CHECK}" >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction reaches a final status.
BODY_FILE=$(mktemp)
trap 'rm -f "${BODY_FILE}"' EXIT
while true; do
  # Transient errors (429, 5xx) are retried, honoring Retry-After.
  HTTP_CODE=$(curl --silent --show-error --fail-with-body \
    --connect-timeout 10 --max-time 60 --retry 5 --retry-delay 2 \
    --output "${BODY_FILE}" --write-out '%{http_code}' \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}" || true)
  case "${HTTP_CODE}" in
    2??) ;;
    000|429|5??)  # dropped connection or temporary error: keep polling
      printf 'Task %s: HTTP %s, polling again in 10s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      sleep 10; continue ;;
    *) printf 'Task %s: HTTP %s\n' "${PREDICTION_ID}" "${HTTP_CODE}" >&2
      cat "${BODY_FILE}" >&2; exit 1 ;;
  esac
  RESULT=$(jq 'if type == "object" and has("data") then .data else . end' "${BODY_FILE}")
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted)
      printf 'Task %s ended with status %s\n' "${PREDICTION_ID}" "${STATUS}" >&2
      printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Every model also accepts the global request options enable_sync_mode and enable_base64_output; see their pages for details.

Response Parameters

Result Request Parameters

Result Response Parameters