---
title: "Generate Segment Assets Endpoint"
method: POST
path: "/segments/generate-all"
tags: ["segments"]
---

# Generate Segment Assets Endpoint

`POST /segments/generate-all`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/segments/generate-all`
- Auth: HTTP bearer

Generate a project's segment assets — images, clips, overlays and
fetched B-roll / real photos.

With no targets it fills gaps: every asset not yet generated (or stale,
or failed) and not already generating, within `asset_scope`, outside
segments being rewritten. Named targets — `assets` (segment asset ids,
each with optional model / settings / editable_sections, saved to the
asset's prompt editor) or `segment_numbers` — run exactly those,
re-rendering finished ones. A real photo placed over a segment's image
re-fetches only when its asset id is named.
`dry_run` returns the count and credit estimate without queueing.

## Request body

- GenerateSegmentAssetsRequest
  - `project_id` string, required
  - `assets` SegmentAssetTarget[], nullable
    - `model` string
    - `editable_sections` object
    - `settings` object
    - `segment_asset_id` string, required
  - `segment_numbers` integer[], nullable
  - `asset_scope` 'all' | 'no_clips' | 'clips_only'
  - `dry_run` boolean

## Response `200`

Successful Response

- GenerateSegmentAssetsResponse
  - `status` string, required
  - `asset_count` integer, required
  - `estimated_credits` integer, required
  - `segment_count` integer, required
  - `available_credits` integer, nullable
  - `video_asset_count` integer, nullable
  - `video_credits` integer, nullable
  - `jobs` SegmentAssetJob[]
    - `segment_asset_id` string, required
    - `job_id` string, required

## Other responses

- `422`: Validation Error

---

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