Name: Qwen Image Edit Plus Next Scene Cinematic Shot API
Brand: magicapi
SKU: api-magicapi-next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene
Availability: InStock
Author: API Market

Shashank Agarwal

# 🎬 Next Scene Image Editing API - Cinematic Camera Moves (Qwen Image Edit Plus LoRA)

## Overview
Next Scene is an image editing model built on Qwen-Image-Edit-Plus with a Next Scene LoRA adapter. Its developer describes it as cinematic "next beat" edits that keep the subject's identity while steering the shot to the next camera move.

Send a frame as `image` and a `prompt` that starts with `Next Scene:` followed by the camera move, framing and lighting of the next shot. The default prompt already uses this format, so `image` is the only required field. Each request returns a list with the URL of one image.

## Features
- **Next shot from one frame**: describe a camera move such as a pull-back, push-in or change of angle, and the model renders the scene as the following shot.
- **Prompt format**: start the prompt with `Next Scene:`, then describe the camera move, framing and lighting.
- **Aspect ratio**: `match_input_image` (default) keeps the shape of your image; you can also choose `1:1`, `16:9`, `9:16`, `4:3` or `3:4`.
- **Speed or detail**: `go_fast` set to `true` runs an 8-step preset, `false` runs a 40-step preset. Set `num_inference_steps` (1 to 40) to choose the step count yourself.
- **LoRA controls**: `lora_scale` (0 to 4) sets the strength of the Next Scene adapter; `lora_weights` swaps in different LoRA weights, such as your own LoRA file.
- **Guidance**: `true_guidance_scale` (0 to 10, default 1).
- **Output format**: `webp` (default), `jpg` or `png`, with `output_quality` from 0 to 100 for lossy formats.
- **Seed**: set `seed` to reproduce a result.

## Use Cases
1. **Storyboards**: turn one key frame into the next shots of a sequence.
2. **Shot exploration**: try wide, close or high-angle versions of a scene before committing to one.
3. **Visual storytelling**: build a short series of frames for comics, pitches or social posts by feeding each output back in as the next `image`.
4. **Lighting changes between shots**: move the same scene from midday to late-afternoon or evening light.

## Visual Examples
### Example Input
Input image:

![Example input: the starting frame](https://blog.api.market/wp-content/uploads/2026/09/kling-v2-1-input-api-market.webp)

Prompt: "Next Scene: The camera pulls back and rises to a high wide angle, revealing the full landscape under warm late-afternoon light with long soft shadows."

All other fields were left at their defaults (`match_input_image`, `webp`).

### Example Output
![Next Scene output: the scene from the input shown from the higher, wider angle in warm late-afternoon light requested in the prompt](https://blog.api.market/wp-content/uploads/2026/10/qwen-image-edit-plus-lora-next-scene-output-api-market.webp)

## Input Parameters
| Field | Type | Required | Default | Allowed values | Description |
| --- | --- | --- | --- | --- | --- |
| `image` | string (URL) | Yes |  |  | Image URL (jpeg, png, gif or webp). |
| `prompt` | string | No | `Next Scene: The camera glides forward as warm cinematic light reveals the wider setting.` |  | Prompt hint: start with `Next Scene:` then describe the new camera move, framing, and lighting so the shot feels like the next beat in a cinematic sequence. |
| `aspect_ratio` | string | No | `match_input_image` | `match_input_image`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4` | Aspect ratio for the generated image |
| `go_fast` | boolean | No | none |  | If num_inference_steps is omitted, true runs the 8-step Lightning preset and false runs the 40-step detailed preset. |
| `num_inference_steps` | integer | No | none | 1 to 40 | Explicit denoising step count (1-40). Leave blank to use the go_fast presets (fast = 8 steps, slow = 40 steps). |
| `lora_weights` | string | No | `""` |  | LoRA weights to apply. Leave blank to use the default Next Scene adapter, or point it at your own LoRA file (for example a public huggingface.co URL). |
| `lora_scale` | number | No | none | 0 to 4 | Strength applied to the selected LoRA. Leave blank for the default strength. |
| `true_guidance_scale` | number | No | `1` | 0 to 10 | True classifier-free guidance scale passed to the pipeline. |
| `seed` | integer | No | none |  | Random seed. Set for reproducible generation. |
| `output_format` | string | No | `webp` | `webp`, `jpg`, `png` | Format of the output images. |
| `output_quality` | integer | No | `95` | 0 to 100 | Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs. |
| `disable_safety_checker` | boolean | No | `false` |  | Disable safety checker for generated images. |

## Pricing
- **Pay As You Go (PAYG) pricing**: you only pay for what you use.
- **Price**: $0.038 per API unit.
- **1 API unit = 1 output image.** Each request returns one image (a one-item list), so each successful request costs $0.038.
- Every input setting (aspect ratio, step count, output format) is billed the same. The example request above cost $0.038.
- **Failed or cancelled predictions are not billed.**
- **GET requests to check prediction status** are free and don't count toward API unit usage.
- **No monthly subscription fee.**

## API Documentation

### Base URL
All API requests go to: `https://prod.api.market/api/v1/magicapi/next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene`

### Authentication
Send your api.market API key in the `x-api-market-key` header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: This API is asynchronous. The flow is:
1. Send a POST request to `/predictions`. A successful request returns **201 Created** with a prediction `id` and a `status` of `starting` or `processing`.
2. Poll GET `/predictions/{id}` with that ID.
3. Keep polling while `status` is `starting` or `processing`.
4. Stop when `status` is `succeeded` (read `output`), `failed` or `canceled` (read `error`).

A polling interval of 1 second and an overall timeout of 600 seconds (10 minutes) work well.

### Endpoints

#### Create a Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "8a060e5c901515797bcfa1ab9050575be0dec05fa6c96e6decd3c6d4d8e17aa8",
    "input": {
      "image": "https://blog.api.market/wp-content/uploads/2026/09/kling-v2-1-input-api-market.webp",
      "prompt": "Next Scene: The camera pulls back and rises to a high wide angle, revealing the full landscape under warm late-afternoon light with long soft shadows."
    }
  }'
```

Response (201 Created):
```json
{
  "id": "471914m0rsrmr0d17g4b6xdwdc",
  "version": "8a060e5c901515797bcfa1ab9050575be0dec05fa6c96e6decd3c6d4d8e17aa8",
  "status": "starting",
  "created_at": "2026-10-14T20:09:12.745Z"
}
```

#### Check Prediction Status
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

Response when the prediction has finished (200 OK):
```json
{
  "id": "471914m0rsrmr0d17g4b6xdwdc",
  "status": "succeeded",
  "output": [
    "https://blog.api.market/wp-content/uploads/2026/10/qwen-image-edit-plus-lora-next-scene-output-api-market.webp"
  ],
  "error": null,
  "created_at": "2026-10-14T20:09:12.745Z",
  "started_at": "2026-10-14T20:09:13.745Z",
  "completed_at": "2026-10-14T20:09:27.745Z"
}
```

`output` is a list of URL strings. It holds one generated image, in the format set by `output_format`.

### Status Codes
- **201 Created**: prediction created (POST `/predictions`). This is the normal success response.
- **200 OK**: prediction details returned (GET `/predictions/{id}`).
- **400 Bad Request**: invalid input, for example a missing `image` or a `num_inference_steps` outside 1 to 40.
- **401 Unauthorized**: missing or invalid API key.
- **404 Not Found**: no prediction with that ID.
- **429 Too Many Requests**: rate limit exceeded.
- **500 Internal Server Error** or **503 Service Unavailable**: temporary server problem; retry later.

## Rate Limits

All plans allow 10 requests per second. Requests above that return `429 Too Many Requests`; back off before retrying and honour any `Retry-After` header. Polling a prediction with GET is free but still counts toward the per-second limit, so poll every 1 to 5 seconds rather than in a tight loop.

## Error Handling
- Check the HTTP status code of every request and read the response body for the error message.
- A prediction can also end with `status` set to `failed`; the `error` field then explains why. Failed predictions are not billed.
- Retry 429, 500 and 503 responses with exponential backoff. Fix the input before retrying a 400.

## Implementation Guide
### Example Code

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene";

async function createAndWaitForPrediction(input) {
  const response = await fetch(`${baseUrl}/predictions`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey
    },
    body: JSON.stringify({ version: "8a060e5c901515797bcfa1ab9050575be0dec05fa6c96e6decd3c6d4d8e17aa8", input })
  });

  if (response.status !== 201) {
    throw new Error(`API error: ${response.status} ${await response.text()}`);
  }

  const prediction = await response.json();
  return pollForResults(prediction.id);
}

const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function pollForResults(predictionId) {
  const maxTimeout = 600000;
  const pollInterval = 1000;
  const startTime = Date.now();

  while (Date.now() - startTime < maxTimeout) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: { "x-api-market-key": apiKey }
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${await response.text()}`);
    }

    const prediction = await response.json();

    if (prediction.status === "succeeded") {
      return prediction.output;
    }

    if (prediction.status === "failed" || prediction.status === "canceled") {
      throw new Error(`Prediction ${prediction.status}: ${prediction.error || "Unknown error"}`);
    }

    await delay(pollInterval);
  }

  throw new Error("Prediction timed out after 10 minutes");
}

createAndWaitForPrediction({
  "image": "https://blog.api.market/wp-content/uploads/2026/09/kling-v2-1-input-api-market.webp",
  "prompt": "Next Scene: The camera pulls back and rises to a high wide angle, revealing the full landscape under warm late-afternoon light with long soft shadows."
}).then((output) => console.log(output));
```

#### Python
```python
import time
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/next-scene-cinematic-image-editing-qwen-edit-apps-qwen-image-edit-plus-lora-next-scene"

def create_and_wait_for_prediction(input_data):
    headers = {"Content-Type": "application/json", "x-api-market-key": API_KEY}
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"version": "8a060e5c901515797bcfa1ab9050575be0dec05fa6c96e6decd3c6d4d8e17aa8", "input": input_data},
    )

    if response.status_code != 201:
        raise Exception(f"API error: {response.status_code} {response.text}")

    return poll_for_results(response.json()["id"])

def poll_for_results(prediction_id):
    max_timeout = 600
    poll_interval = 1
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()

    while time.time() - start_time < max_timeout:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)

        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")

        prediction = response.json()

        if prediction["status"] == "succeeded":
            return prediction["output"]

        if prediction["status"] in ("failed", "canceled"):
            raise Exception(f"Prediction {prediction['status']}: {prediction.get('error') or 'Unknown error'}")

        time.sleep(poll_interval)

    raise Exception("Prediction timed out after 10 minutes")

print(create_and_wait_for_prediction({
  "image": "https://blog.api.market/wp-content/uploads/2026/09/kling-v2-1-input-api-market.webp",
  "prompt": "Next Scene: The camera pulls back and rises to a high wide angle, revealing the full landscape under warm late-afternoon light with long soft shadows."
}))
```

## FAQ
- **Why should the prompt start with `Next Scene:`?**
  - The prompt hint for this adapter asks for it. Write `Next Scene:` first, then the camera move, framing and lighting, for example "Next Scene: The camera pushes in to a close-up of the rider as rain starts to fall."
- **Does the subject stay the same?**
  - The developer describes the adapter as keeping the subject's identity while the camera moves. Results depend on how far the requested move is from the input frame.
- **Can I build a sequence of shots?**
  - Yes. Send each output URL back as `image` with the next `Next Scene:` prompt. Each request is billed as one image.
- **How do I trade speed for detail?**
  - Leave `num_inference_steps` empty and set `go_fast` to `true` for the 8-step preset or `false` for the 40-step preset. Or set `num_inference_steps` (1 to 40) yourself.
- **How many images does one request return, and what does it cost?**
  - One image, returned as a one-item list in `output`. It costs $0.038.
- **Is the 201 response from POST an error?**
  - No. 201 Created means the prediction was accepted. Use the returned `id` to poll GET `/predictions/{id}` until `status` is `succeeded`, `failed` or `canceled`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Generate the next cinematic shot from a single frame with a Next Scene LoRA on Qwen-Image-Edit-Plus: new camera moves, framing and lighting. $0.038 per image.

Qwen Image Edit Plus Next Scene Cinematic Shot API