Generate with guided recipe
generate_with_recipeCreate one image or clip with a guided recipe — an arm or reprompt recipe. Supply creative_prompt and one value for every choice get_recipe declares; bind existing account media, or a Subject as { type: "subject", subject_id }, to the recipe's inputs by key — an input with takes_subject takes one, and naming her beats attaching a picture of her. Optionally pick another model of the recipe's medium instead of its default: its recommended_models are the ones its author tested, and any other model of the medium runs it too unless it cannot take an input the recipe requires (a reference photo, a start frame, the pinned voice) — that is refused as RECIPE_MODEL_UNFIT with the reason. A pinned setting the model cannot take (a ratio, resolution, length or format) moves to the nearest one it can, and a model that uses reference photos only in one clip shape is moved into that shape. On a reprompt recipe your answers are the brief a model reads to write the prompt, so say what you want rather than how to phrase it.
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": {
"recipe_id": "<recipe_id>",
"creative_prompt": "<creative_prompt>"
},
"name": "generate_with_recipe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | ||
| choices | No | ||
| runs_on | No | Who pays: "credits", or one of the user's own keys by vendor (get_credits lists them). Leave out to follow their payer order; set it only when the user chose. | |
| model_id | No | ||
| recipe_id | Yes | ||
| creative_prompt | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | ||
| generation | Yes | One image, clip, voice-over or piece of music. |