Generate Get Generation
generate_get-generationRead-only
Retrieve a generation by ID, with wait mode to long-poll until completion and obtain the output URL directly when status is COMPLETED.
Instructions
Get a generation by id. In ChatGPT, pass wait: true and timeout: 55 for generation results instead of making repeated manual polls. When status is COMPLETED, copy the exact structuredContent.outputUrl string verbatim; signed URLs must not be reconstructed, shortened, or edited.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Job ID | |
| wait | No | Explicitly long-poll until the generation reaches a terminal state (COMPLETED, FAILED, REJECTED) or the timeout elapses. On timeout the current state is returned with HTTP 200 - check `status` and retry. Cannot be combined with include=progress. | |
| include | No | Additional information to include in the response | |
| timeout | No | Maximum seconds to block when wait=true (1-10). Default 5. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Sync generation id. | |
| error | No | ||
| model | No | Model used for the generation. | |
| status | No | Current generation status. | |
| errorCode | No | ||
| outputUrl | No | Signed result URL when the generation is complete. Copy this exact string verbatim; do not reconstruct, shorten, or edit it. | |
| outputDuration | No | Output duration in seconds. |