image-change-camera

Change Camera - Transform image perspective

Transform an image by changing the camera angle using AI. Adjust horizontal rotation (0-360 degrees), vertical tilt (-30 to 90 degrees), and zoom level (0-10) to generate a new image as if the camera had been repositioned around the subject.

This is an asynchronous endpoint. After submitting a request, use the task ID to poll for results or provide a webhook_url to receive a notification when processing completes.

Camera controls:

  • Horizontal angle (horizontal_angle): Rotate the viewpoint 0-360 degrees around the subject. 0 = front view, 90 = right side, 180 = back view, 270 = left side.
  • Vertical angle (vertical_angle): Tilt the camera from -30 (looking up) to 90 (bird's eye view). 0 = eye level.
  • Zoom (zoom): Adjust from 0 (wide shot, full scene) to 10 (close-up).

Use cases: Product photography with multiple angle views, architectural visualization, creative image manipulation, and generating consistent multi-angle views of objects and scenes.

post/v1/ai/image-change-camera

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/image-change-camera
  • Auth: API key in header x-magnific-api-key

Request body

imagestring required

Input image to transform. Provide as a publicly accessible HTTPS URL. Supported formats: JPG, PNG, WebP.

horizontal_angleinteger

Horizontal rotation angle in degrees. Controls the left-right rotation of the camera around the subject.

  • 0: Front view (no rotation)
  • 90: Right side view
  • 180: Back view
  • 270: Left side view
  • 360: Full rotation (equivalent to 0)

Valid values: 0 to 360. Default: 0.

vertical_angleinteger

Vertical tilt angle in degrees. Controls the up-down tilt of the camera relative to the subject.

  • -30: Looking up at the subject from below
  • 0: Eye-level view (no tilt)
  • 45: Moderate downward angle
  • 90: Bird's eye view (directly above)

Valid values: -30 to 90. Default: 0.

zoominteger

Zoom level controlling how close the camera appears to the subject.

  • 0: Wide shot (far away, full scene visible)
  • 5: Medium shot (standard framing)
  • 10: Close-up (very close to the subject)

Valid values: 0 to 10. Default: 5.

seedinteger

Seed for the random number generator. Using the same seed with identical parameters produces the same output, enabling reproducible results across multiple requests.

output_format'png' | 'jpeg'

Output image format.

  • png: Lossless compression, best for high-quality results
  • jpeg: Lossy compression, smaller file size suitable for web use
webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example request

{
  "image": "https://example.com/input-image.jpg",
  "horizontal_angle": 45,
  "vertical_angle": 15,
  "zoom": 5,
  "seed": 42,
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.