API reference · Account
Publish a recipe from your own film
POST/api/studio/recipesSigned in session
A shot recipe or an ad template, with one of the account's own live shares as its sample if wanted. At its link at once, listed once the operator approves it. Personal accounts only, at most 50 an account. Same origin only.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| kindrequired | string | One of "shot", "ad". |
| titlerequired | string | At most 80 characters. |
| about | string | At most 400 characters. |
| bodyrequired | object | |
| share_id | string |
Example
{
"kind": "shot",
"title": "string",
"body": {
"prompt": "Say hello in five words.",
"model": "antimatter/auto"
}
}Answer 200
The recipe as published.
| Field | Type | What it is |
|---|---|---|
| id | string | srx_ followed by 24 hex digits. |
| object | string | One of "studio.recipe". |
| kind | string | One of "shot", "ad". |
| title | string | |
| about | string or null | |
| body | object | |
| share_id | string or null | The creator's own live share that plays as its sample. |
| state | string | One of "pending", "listed", "declined". |
| path | string | Its page on this origin. |
| created_at | integer | |
| reviewed_at | integer or null |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 403OpenAI shaped error.
- 409OpenAI 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.