Преобразует изображение в подробный текстовый промпт, чтобы вы могли повторить похожую картинку в генераторе изображений. Цена - 1 рубль за изображение.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
image-to-prompt нужен для сценариев, где у вас уже есть референс-изображение и нужно быстро получить по нему подробный текстовый промпт. Инструмент поддерживает два сценария:
Каждый вызов создаёт асинхронную операцию. Сразу после запроса API возвращает id, стартовый статус и стоимость запуска, а готовый результат нужно получать отдельной проверкой статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id, стартовый статус и стоимость.Базовая форма запроса:
{
"tool": "image-to-prompt",
"input": {
"...": "..."
}
}
tool - slug нейросети. Для этой модели всегда используйте "image-to-prompt".input - параметры конкретного запуска.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
image_url | string (url) | Да | Внешний URL исходного изображения. Разрешены только http/https ссылки. Допустимые расширения для Public API: .jpg, .jpeg, .png, .webp. |
has_people | boolean | Нет | Если true, на изображении есть человек или несколько. Если поле не передано, считается false. |
describe_hair | boolean | Нет | Если true, в итоговый текст добавляется более подробное описание волос, причёски и связанных деталей. Имеет смысл использовать только вместе с has_people = true. |
describe_makeup | boolean | Нет | Если true, в итоговый текст добавляется более подробное описание макияжа и косметических деталей. Имеет смысл использовать только вместе с has_people = true. |
describe_physique | boolean | Нет | Если true, в итоговый текст добавляется более подробное описание телосложения и особенностей фигуры. Имеет смысл использовать только вместе с has_people = true. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "image-to-prompt",
"input": {
"image_url": "https://cdn.example.com/source-image-1.jpg",
"has_people": true,
"describe_hair": true,
"describe_makeup": false,
"describe_physique": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'image-to-prompt',
input: {
image_url: 'https://cdn.example.com/source-image-1.jpg',
has_people: true,
describe_hair: true,
describe_makeup: false,
describe_physique: true,
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "image-to-prompt",
"input": {
"image_url": "https://cdn.example.com/source-image-1.jpg",
"has_people": True,
"describe_hair": True,
"describe_makeup": False,
"describe_physique": True,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "image-to-prompt",
"cost": 1,
"balance_after": 495,
"created_at": "2026-04-09T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "image-to-prompt",
"cost": 1,
"created_at": "2026-04-09T12:00:00Z",
"completed_at": "2026-04-09T12:00:08Z",
"result": {
"type": "text",
"text": "Фотореалистичный портрет девушки крупным планом. Длинные волнистые каштановые волосы, естественный макияж с мягким акцентом на глаза, стройное телосложение, прямой взгляд в камеру, мягкий дневной свет, нейтральный фон, высокая детализация кожи и черт лица."
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "image-to-prompt",
"cost": 1,
"created_at": "2026-04-09T12:00:00Z",
"completed_at": "2026-04-09T12:00:04Z",
"result": null,
"error_message": "Не удалось обработать изображение"
}
После создания операции сохраните её id. Именно по нему проверяется текущий статус.
GET /api/v1/operations/{id}curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
const response = await fetch('https://bratuha.ru/api/v1/operations/op_uuid-123', {
headers: {
Authorization: 'Bearer brth_ваш_ключ',
},
})
const data = await response.json()
console.log(data)
После завершения операции в result возвращается текст:
{
"type": "text",
"text": "Подробный текстовый промпт по изображению"
}
type всегда равен text.text содержит готовое описание изображения, которое можно использовать как основу для дальнейшей генерации или редактирования.has_people, describe_hair, describe_makeup и describe_physique.POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.queued, затем проверяете статус по id.image_url разрешены только внешние http/https URL без localhost, loopback и private IP..jpg, .jpeg, .png, .webp.HEIC/HEIF, которые могут поддерживаться при загрузке через UI, в Public API по внешнему URL не используются.validation_error.has_people можно не передавать или передать false.has_people = false, поля describe_hair, describe_makeup и describe_physique можно не передавать.