Create a short from an existing script job

curl --request POST \ --url https://api.yalg.ai/v1/shorts/from-script/{scriptJobId} \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "title": "The 30-second lesson", "brief": "Turn this idea into a fast short with a direct hook.", "selectedAnecdoteIds": [ "018f9f41-22a1-74bb-9450-7dd0d21ab8ab" ] } '

{ "id": "018f9f43-1a76-7b1e-a3ce-f01cce71c641", "title": "The 30-second lesson", "status": "draft", "sourceScriptJobId": "018f9f42-9c1d-7b12-97c4-8142b8a27c90", "thumbnailStatus": "pending", "createdAt": "2026-06-20T17:24:39.000Z", "updatedAt": "2026-06-20T17:24:39.000Z" }

Authorizations

x-api-key

string

header

default:yalg_live_your_api_key

required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Path Parameters

scriptJobId

string

required

Script job identifier.

Example:

"018f9f42-9c1d-7b12-97c4-8142b8a27c90"

Body

application/json

title

string

Optional title override for the short

brief

string

Optional brief override for the short

selectionMode

enum<string>

default:auto

Anecdote selection mode. V1 supports auto only.

Available options:

auto

Response

Short created from script job with status CREATED (not queued - manual trigger required)

Short-form video generation job.

string<uuid>

Job identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

status

string

Example:

"pending"

currentStep

string

Example:

"draft_generation"

qualityScore

number

Example:

0.91

riskLevel

string

Example:

"low"

warnings

string[]

totalTokensUsed

integer

Example:

1284

startedAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

completedAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

createdAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

updatedAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

title

string

Example:

"The 30-second lesson"

sourceScriptJobId

string<uuid>

Source script job identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

thumbnailStatus

string

Example:

"pending"