> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi Angles

> Re-render the same subject from a different camera angle. Pick a horizontal view, a vertical angle, and a shot distance: the model rotates the camera around the subject and re-renders the scene from that pose.

<Info>
  Pricing: **\$0.2/request**. Endpoint: `POST /v1/models/runflow/multi-angles/runs`.
</Info>

Re-render the same subject from a different camera angle. Pick a horizontal view, a vertical angle, and a shot distance: the model rotates the camera around the subject and re-renders the scene from that pose.

## Overview

* **Endpoint**: [https://api.runflow.io/v1/models/runflow/multi-angles/runs](https://api.runflow.io/v1/models/runflow/multi-angles/runs)
* **Model ID**: runflow/multi-angles
* **Provider**: Runflow
* **License**: commercial
* **Last Updated**: 2026-05-28

## Pricing

* **Base price**: \$0.2/request
* **Note**: Per image. Multi-angle camera rotation.

# Multi Angles API

**Endpoint:** `POST /v1/models/runflow/multi-angles/runs`

## Run the model

### Python

```python theme={"dark"}
import requests

response = requests.post(
    "https://api.runflow.io/v1/models/runflow/multi-angles/runs",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "input": {
            "shot": "medium shot",
            "view": "right side view",
            "angle": "eye-level shot",
            "image_url": "https://public.runflow.io/images/models/runflow/product-isolation/examples/1/before.webp"
        },
        "callback_url": "https://your-server.com/webhook"
    },
)

data = response.json()
print(data)
```

### Node.js

```javascript theme={"dark"}
const response = await fetch(
  "https://api.runflow.io/v1/models/runflow/multi-angles/runs",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "input": {
            "shot": "medium shot",
            "view": "right side view",
            "angle": "eye-level shot",
            "image_url": "https://public.runflow.io/images/models/runflow/product-isolation/examples/1/before.webp"
        },
        "callback_url": "https://your-server.com/webhook"
    }),
  }
);

const data = await response.json();
console.log(data);
```

### cURL

```bash theme={"dark"}
curl -X POST https://api.runflow.io/v1/models/runflow/multi-angles/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
    "input": {
        "shot": "medium shot",
        "view": "right side view",
        "angle": "eye-level shot",
        "image_url": "https://public.runflow.io/images/models/runflow/product-isolation/examples/1/before.webp"
    },
    "callback_url": "https://your-server.com/webhook"
}
JSON
```

## Request parameters

| Parameter      | Type           | Required | Description                                                 |
| -------------- | -------------- | -------- | ----------------------------------------------------------- |
| `input`        | object         | required | Model input parameters. See "Input schema" below.           |
| `callback_url` | string \| null | optional | Webhook URL - POSTed when the run reaches a terminal state. |
| `metadata`     | object \| null | optional | Arbitrary key-value pairs attached to the run.              |

## Input schema

| Field                | Type   | Required | Allowed values                                                                                                                                                             | Description                                                                                                                                                                                                                             |
| -------------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `image_url`          | image  | required | Any                                                                                                                                                                        | HTTPS URL of the source photo. A clear subject and even lighting work best.                                                                                                                                                             |
| `view`               | string | required | `front view`, `front-right quarter view`, `right side view`, `back-right quarter view`, `back view`, `back-left quarter view`, `left side view`, `front-left quarter view` | Where the camera sits horizontally around the subject. "front view" looks at the subject head-on; "right side view" rotates 90 degrees clockwise; "back view" looks from behind; and so on for the 8 cardinal + diagonal positions.     |
| `angle`              | string | optional | `low-angle shot`, `eye-level shot`, `elevated shot`, `high-angle shot`                                                                                                     | Vertical camera tilt. "low-angle shot" looks up from ground level (-30 degrees); "eye-level shot" matches the subject's height; "elevated shot" sits slightly above (30 degrees); "high-angle shot" looks down from above (60 degrees). |
| `shot`               | string | optional | `close-up`, `medium shot`, `wide shot`                                                                                                                                     | Camera distance. "close-up" fills the frame with surface and texture detail; "medium shot" is a balanced standard framing; "wide shot" pulls back to include context and environment.                                                   |
| `prompt`             | string | optional | Any                                                                                                                                                                        | Optional extra phrase appended to the camera pose to nudge the output (e.g. "keep the original lighting"). Leave blank for default behavior.                                                                                            |
| `match_input_aspect` | string | optional | `true`, `false`                                                                                                                                                            | Keep the output at the source image's aspect ratio. Default. Set to "false" if you want to force a specific aspect\_ratio.                                                                                                              |
| `aspect_ratio`       | string | optional | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `21:9`                                                                                                                  | Output aspect ratio. Only takes effect when match\_input\_aspect is "false".                                                                                                                                                            |

## Output schema

| Field           | Type | Description                                                |
| --------------- | ---- | ---------------------------------------------------------- |
| `outputs`       | json | Array of result items, each with at minimum a `url` field. |
| `seed`          | json | Random seed used (null if N/A).                            |
| `timing`        | json | Provider timing breakdown (null if not surfaced).          |
| `nsfw_detected` | json | Provider NSFW flag (null if not surfaced).                 |

## Callback payload

When you provide a `callback_url`, Runflow POSTs to it once the run reaches a terminal state.

| Field          | Type           | Description                                                    |
| -------------- | -------------- | -------------------------------------------------------------- |
| `event`        | string         | Event type: "run.completed", "run.failed", or "run.cancelled". |
| `run_id`       | string         | The unique identifier of the run.                              |
| `status`       | string         | Terminal status: "succeeded", "failed", or "cancelled".        |
| `output`       | object \| null | The run output. Null if the run failed or was cancelled.       |
| `duration_ms`  | number \| null | Total run duration in milliseconds.                            |
| `created_at`   | string \| null | ISO 8601 timestamp when the run was created.                   |
| `completed_at` | string \| null | ISO 8601 timestamp when the run reached terminal state.        |
| `metadata`     | object \| null | The metadata object passed at run creation, if any.            |

* **Retries:** 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
* **Headers:** `Runflow-Request-Id` is always sent. `Runflow-Signature` is sent if a signing secret is configured.

## Additional Resources

* [Playground](https://app.runflow.io/models/runflow/multi-angles)
* [API Reference](https://app.runflow.io/models/runflow/multi-angles?tab=api)
* [Documentation](https://docs.runflow.io)
* [OpenAPI](https://docs.runflow.io/api/openapi.public.json)

## Related

<CardGroup cols={2}>
  <Card title="Browse all models" icon="grid" href="/models">Browse the catalog.</Card>
  <Card title="Run lifecycle" icon="play" href="/concepts/runs">Callbacks, polling, statuses.</Card>
  <Card title="Callbacks" icon="webhook" href="/concepts/callbacks">Handle async results.</Card>
  <Card title="Pricing" icon="coin" href="/concepts/pricing">How requests bill out.</Card>
</CardGroup>