Удобный режим, где задание и фотографии можно отправить сразу в несколько нейросетей или быстро переключиться на другую модель — всё в одном окне, без необходимости заново вводить промпт и загружать файлы.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус.{
"tool": "photostudio",
"input": {
"prompt": "Портрет человека в неоновом городе, мягкий свет, высокая детализация",
"dispatch": {
"operation_count": 1
}
}
}
Параметры передаются напрямую внутри объекта input. Дополнительный вложенный объект input не нужен.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
image_urls | string[] (url) | Нет | Массив внешних URL изображений. Разрешены только http/https ссылки. Максимум файлов: 10. Допустимые расширения: .jpg, .jpeg, .png, .webp. |
prompt | string | Да | — |
dispatch.operation_count | number | Да | — |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "photostudio",
"input": {
"prompt": "Портрет человека в неоновом городе, мягкий свет, высокая детализация",
"dispatch": {
"operation_count": 1
}
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tool": "photostudio",
"input": {
"prompt": "Портрет человека в неоновом городе, мягкий свет, высокая детализация",
"dispatch": {
"operation_count": 1
}
}
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
"tool": "photostudio",
"input": {
"prompt": "Портрет человека в неоновом городе, мягкий свет, высокая детализация",
"dispatch": {
"operation_count": 1
}
}
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "photostudio",
"cost": 2,
"balance_after": 495,
"created_at": "2026-03-13T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "photostudio",
"cost": 2,
"created_at": "2026-03-13T12:00:00Z",
"completed_at": "2026-03-13T12:00:24Z",
"result": {
"type": "file",
"files": [
{
"url": "https://storage.bratuha.ru/results/photostudio/result.zip",
"name": "result.zip"
}
]
},
"error_message": null
}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
Возможные типы результата зависят от конфигурации инструмента.
POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.queued, затем проверяете статус по id.http/https ссылки без localhost, loopback и private IP.validation_error.HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, к Public API по URL не относятся. Для API используйте JPG, JPEG, PNG или WebP.