Generation section
The main generation area combines three panels:| Panel | Purpose |
|---|---|
Schema | Shows the selected endpoint path and the current model fields |
Request Body | Lets you fill the request payload |
Response | Shows loading progress, errors, and the JSON response |
Before you send
To send a request successfully, the page needs all of these:| Requirement | How it is enforced |
|---|---|
| Model selected | The page loads the schema and default body from the current model identifier |
| API key present | The top bar must contain a non-empty API key |
| API key locked | The send button stays disabled until you lock the key |
| Required fields filled | The form shows Fill required: ... when required values are missing |
Send a generation request
Choose region, type, and model
Select
US or EU, choose Image or Video, then pick a model identifier.Lock your API key
Paste your key into the top bar and click the lock button. The button title switches between
Lock API key and Unlock API key.Complete the request body
Fill the fields in the Request Body panel. Use the reset button if you want to restore the current model defaults.
Click Send request
The page sends a
POST request to /v1/generate/{image|video}/{model_identifier} for the selected region.What the response panel shows
The Response header can show these items:| Element | When it appears |
|---|---|
Response title | Always |
| HTTP status badge | After a response is received |
| Elapsed milliseconds | While the request is still loading |
| Final latency | After the request finishes |
| Line count | When a JSON response is present |
JSON badge | Always |
| Copy button | Always |
| Hint text |
|---|
Async response - subscribe to webhooks for real-time status and output delivery |
Loading timeline
While a request is in progress, the panel shows a live timeline. If your request includesgeneration_provider_order, the timeline uses that provider order to show failover progress.
The page also uses the internal GET /api/playground/generation-status/{generation_id} helper to improve the timeline after a generation row exists.
Error states
The page can show these error messages before or after the request is sent:| Situation | Message |
|---|---|
| API key missing when sending | Please lock your API key first |
| Invalid model type | Invalid model type |
| Unknown model | Unknown model |
| Invalid endpoint shape | Invalid endpoint path |
| Invalid API key value | Invalid API key format |
| Required field missing | Missing required field: {field_name} |
| Oversized response | Response too large |
| Non-JSON response | Invalid JSON response from server |
| Aborted by timeout | Request timed out |
After you receive generation_id
Most generation responses include a generation_id in the JSON body.
After you have that value, you can:
- Open the management section and use
Content Info,Cancel Generation, orDelete Content. - Call the public content routes directly from your own app.
- Configure Webhook in your workspace for asynchronous delivery.