API reference · Account
Rename a preset or replace its recipe
PATCH/api/studio/presets/{id}Signed in session
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string | The preset's id, spr_ followed by hex. |
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| name | string | At most 80 characters. |
| recipe | object | What the preset sets on a shot; at least one field. |
| recipe. | string | At most 4000 characters. |
| recipe. | string or null | One of "push-in", "pull-out", "orbit", "crane-up", "dolly-zoom", "tracking", "handheld", "drone", "whip-pan", "static", null. |
| recipe. | string | One of "none", "teal-orange", "noir", "bleach", "dusk", "nebula", "film", "vivid". |
| recipe. | string | One of "wide", "normal", "portrait", "macro", "anamorphic", "tele", "fisheye". |
| recipe. | string | One of "portrait", "tungsten", "slide", "mono", "super8", "16mm". |
| recipe. | string | |
| recipe. | number |
Example
{
"name": "string",
"recipe": {
"prompt": "Say hello in five words.",
"model": "antimatter/auto"
}
}Answer 200
The preset.
| Field | Type | What it is |
|---|---|---|
| id | string | spr_ followed by hex. |
| object | string | One of "studio.preset". |
| name | string | |
| recipe | object | What the preset sets on a shot; at least one field. |
| recipe. | string | At most 4000 characters. |
| recipe. | string or null | One of "push-in", "pull-out", "orbit", "crane-up", "dolly-zoom", "tracking", "handheld", "drone", "whip-pan", "static", null. |
| recipe. | string | One of "none", "teal-orange", "noir", "bleach", "dusk", "nebula", "film", "vivid". |
| recipe. | string | One of "wide", "normal", "portrait", "macro", "anamorphic", "tele", "fisheye". |
| recipe. | string | One of "portrait", "tungsten", "slide", "mono", "super8", "16mm". |
| recipe. | string | |
| recipe. | number | |
| created_at | integer | |
| updated_at | integer |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 404OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.