Passer à la navigation
API de génération

list generations

list sync. labs generations and filter jobs by status or generation id. review authentication, request parameters, response objects, and api errors.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Paramètres de requête

statuslist of enumsOptionnel

Filter generations by status. Accepts multiple statuses as a comma-separated list.

Valeurs autorisées:
idslist of stringsOptionnel

Filter generations by ID. Accepts multiple IDs as a comma-separated list.

sourcelist of stringsOptionnel

Filter generations by source. Accepts multiple sources as a comma-separated list.

projectIdstringOptionnel
Return only generations in this project. Must be a UUID. A project you can't access returns an empty list.
limitintegerOptionnel

Maximum number of generations to return (1-100). When set, results are ordered newest first and can be paged with cursor.

cursorstringOptionnel

ID of the last generation on the previous page. Requires limit.

Réponse

Generations retrieved successfully
createdAtdatetime
The date and time the generation was created.
idstring
A unique identifier for the generation.
inputlist of objects
An array of input objects used for generation.
modelenum
The name of the model used for generation.
Valeurs autorisées:
statusenum
The status of the generation.
Valeurs autorisées:
errorstringOptionnel
The error message if the generation failed.
errorCodestringOptionnel

Stable, machine-readable error code if the generation failed (e.g. generation_input_video_inaccessible). The full catalog of codes, messages and suggested fixes is served unauthenticated at GET /v2/errors.

optionsobjectOptionnel
Options for the generation.
outputDurationdoubleOptionnel
The duration of the output media.
outputUrlstringOptionnel
The URL of the output media.
outputFileNamestringOptionnel
The sanitized filename applied to the output media. Characters outside letters, numbers, dashes and underscores are stripped and spaces become underscores, so this can differ from the value submitted. Null when no name was provided.
segmentslist of objectsOptionnel
The segments of the generation.
segmentOutputUrlstringOptionnel
The URL of the segment output media.
dubAudioUrlstring or nullOptionnel

Dubbed audio URL. Omitted for generations without dubParams; null until the dubbed track is available.

dubAudioAssetIdstring or nullOptionnel

Reusable AUDIO asset for the dubbed track. Omitted without dubParams; null until available, or when retention settings or a custom output bucket prevent saving an asset.

synthesizedAudioUrlstringOptionnel

The URL of the audio synthesized from a text (TTS) input. Only present for generations created with a TTS text input; reuse it as an audio input to keep the same take across generations.

webhookUrlstringOptionnel
The URL to the webhook endpoint.
projectIdstringOptionnel
The id of the project this generation is attached to, or null when it belongs to no project. Set via the projectId field on the create request.
generationEstimateobjectOptionnel

A completion-time estimate captured once when the generation is accepted. Populated only for generations created in sync’s own apps, such as Sync Studio; the field is absent for generations created through the API today. To get an expected finish time for any generation, request it with include=progress and read progress.estimatedFinishAt.

progressobjectOptionnel

Render progress and expected finish. Only included when the generation is requested with include=progress.

Erreurs

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error