---
title: "List generations in a project"
method: GET
path: "/v1/generations"
tags: ["Generations"]
---

# List generations in a project

`GET /v1/generations`

## Request

- Base URL: `https://nanostudiopro.com/api`
- URL: `https://nanostudiopro.com/api/v1/generations`
- Auth: HTTP bearer

Returns all generations under a given project, newest-first. Each item includes a time-limited signed `image_url` you can use to display or download the result without re-fetching the file separately.

Every item carries `generation_type`. A clip (`generation_type: "video"`) also carries `is_video: true`, a signed `video_url`, `poster_url` (the same still as `image_url`) and `duration_seconds` when known.

**Tip:** if you don't have a project ID yet, call `GET /v1/projects` first and copy one from the response.

## Query parameters

- `project_id` string, required
- `limit` integer
- `offset` integer

## Response `200`

Paginated generations

- object
  - `items` Generation[]
    - `id` string
    - `project_id` string
    - `name` string, nullable
    - `metadata` object, nullable: The fields you sent as `metadata` when uploading or importing it, returned unchanged.
    - `image_url` string, uri: Signed URL to the generated image. Tied to a ~6-hour signing window (always at least 10 minutes of validity left); re-fetch the resource for a fresh one.
    - `prompt_used` string: The full prompt sent to the model — includes the aspect/resolution directive we append.
    - `aspect_ratio` '1:1' | '4:5' | '3:4' | '9:16' | '16:9' | '3:2' | '2:3'
    - `resolution` '1K' | '2K' | '4K'
    - `width` integer, nullable: Real width in pixels (if measured).
    - `height` integer, nullable
    - `created_at` string, date-time
  - `total` integer

## Other responses

- `401`: Missing or invalid token
- `404`: Project not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api.md) · [All operations](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/revisions/b454211e598e?raw)