API Reference

The 3DLabs REST API lets you integrate the pipeline into your own tools and workflows. All endpoints require authentication via Clerk session token.

Base URL: https://www.3dlabs.it.com/api

Include the x-workspace-id header on all workspace-scoped requests.

POST/api/claude/stories

Generate a story from a topic

Request body

Field	Type	Required	Description
topic	string	Yes	The subject or prompt for the story
maxMinutes	number	Yes	Target runtime in minutes (1–5)
projectId	string	No	Associate with an existing project
provider	"gemini" \| "claude"	No	LLM provider (default: gemini)

Returns

{ jobId: string }

POST/api/claude/scene-planning

Generate a scene plan from a story

Request body

Field	Type	Required	Description
story	object	Yes	Story object returned by the stories endpoint
maxMinutes	number	Yes	Target runtime in minutes
videoModel	string	No	Target video model (affects duration planning)

Returns

{ jobId: string }

POST/api/images/generate

Generate an image for a scene

Request body

Field	Type	Required	Description
prompt	string	Yes	Image prompt
provider	"replicate" \| "gemini"	Yes	Image provider
model	string	Yes	Model slug (e.g. flux-dev, flux-schnell)
aspectRatio	string	Yes	"16:9" \| "9:16" \| "1:1" \| "4:3"
projectId	string	No	Project to attach the asset to
sceneNumber	number	No	Scene index (1-based)

Returns

{ jobId: string }

GET/api/session/list

List all projects for the current user in the active workspace

Returns

{ sessions: Session[] }

GET/api/session/:id

Load a project session by ID

Returns

Session object with full project data

GET/api/jobs/:jobId

Poll job status and progress

Returns

{ status, progress, result?, error? }

GET/api/workspaces

List all workspaces the authenticated user belongs to

Returns

Workspace[]

This API reference is non-exhaustive. The full API includes additional endpoints for audio, export, assets, webhooks, and admin operations. A complete OpenAPI spec is planned for a future release.