Prepare content from a brief
playground_content_prepareThe easiest way to start making content. Give a short brief and one entry per output you need; intendedUse is optional. You write each image or video prompt yourself: look at the reference image, describe the product (type, colour, material, details that must not change) and the shot (for example hero, lifestyle, detail, or a short motion plan), following the model prompt guide. If a prompt is missing, Berrys returns prompts_required with the reference preview and the guide instead of a quote; write the prompts and call again. Berrys then returns an exact, free credit quote; it does not create nodes or spend credits. For a new creative task, create a fresh project first with playground_project_create; for a follow-up, reuse its projectId. Import any uploaded or linked image to that project first and pass its image node ID as a reference. Audio needs the exact spoken words or lyrics. Review the returned prompts, references, defaults and price with the user; the returned mediaGenerateRequest is the exact input for playground_media_generate with quoteId and a new idempotencyKey when they want to proceed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"brief": "<brief>",
"deliverables": "<deliverables>"
},
"name": "playground_content_prepare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brief | Yes | User’s creative goal, product context and requirements for the deliverables. | |
| locale | No | Language or locale to use for the deliverable text, such as en or id-ID. Language tag such as en, id-ID, th-TH, or vi-VN. | |
| brandId | No | An explicitly selected brand owned by the connected account. Its saved rules are included in the quoted image/video prompts. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| intendedUse | No | Where the content will be used, for example a product listing, social post or ad. Omit when the user has no specific placement. | General creative use |
| deliverables | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | Suggested next action; it does not authorize spending. | |
| brand | No | ||
| brief | No | ||
| items | No | ||
| locale | No | ||
| review | No | ||
| status | Yes | ||
| balance | No | ||
| quoteId | No | ||
| revision | No | ||
| canvasUrl | No | ||
| expiresAt | No | Serialized ISO timestamp. | |
| projectId | No | ||
| assumptions | No | ||
| intendedUse | No | ||
| projectName | No | ||
| promptGuides | No | ||
| totalCredits | No | ||
| validitySeconds | No | ||
| inputFingerprint | No | ||
| itemPromptGuides | No | ||
| sufficientCredits | No | ||
| mediaGenerateRequest | No | ||
| estimatedBalanceAfter | No |