Pricing: $0.2/request. Endpoint: POST /v1/models/runflow/multi-angles/runs.

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
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

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

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

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

Browse all models

Browse the catalog.

Run lifecycle

Callbacks, polling, statuses.

Callbacks

Handle async results.

Pricing

How requests bill out.

​Overview

​Pricing

​Multi Angles API

​Run the model

​Python

​Node.js

​cURL

​Request parameters

​Input schema

​Output schema

​Callback payload

​Additional Resources

​Related

Browse all models

Run lifecycle

Callbacks

Pricing

Overview

Pricing

Multi Angles API

Run the model

Python

Node.js

cURL

Request parameters

Input schema

Output schema

Callback payload

Additional Resources

Related