---
title: "Get render poster image"
method: GET
path: "/v1/renders/{render_id}/poster"
tags: ["renders"]
---

# Get render poster image

`GET /v1/renders/{render_id}/poster`

## Request

- Base URL: `https://api.framelane.io`
- URL: `https://api.framelane.io/v1/renders/{render_id}/poster`
- Auth: HTTP bearer

Redirects to a short-lived signed URL for a completed render's poster IMAGE — e.g. a contact-sheet preview PNG. This is the pixels-you-can-embed counterpart to the MCP `get_render_preview` tool. Returns 422 if the render output is a video; use `/download` for that.

## Path parameters

- `render_id` string, required

## Other responses

- `302`: Redirect to a 5-minute signed URL for the poster image.
- `401`: Missing or invalid API key.
- `404`: Render not found.
- `422`: Render not completed, or its output is a video (no poster).
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/framelane/apis/framelane-api.md) · [All operations](https://skmtc.dev/framelane/apis/framelane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framelane/apis/framelane-api/revisions/a223001ca8e5?raw)