Некоторые инструменты принимают идентификаторы: голос, аватар, трек. Их берут из запросов на этой странице. Все они - GET, бесплатные.
Голоса
GET /voices - любой ключ. Голоса озвучки для POST /video/create, POST /avatar/video и пакета контента (form.voiceId).
curl "https://developers.grem.capital/api/v1/voices?language=de" \
-H "Authorization: Bearer gsk_live_xxx"
language (необязательно) - код языка ISO 639-1: оставляет голоса, которые на нем говорят.
| Поле | Описание |
|---|---|
items[].voiceId | id для поля voiceId |
items[].name | имя голоса |
items[].gender | male или female |
items[].description | характер голоса |
items[].languages | языки, на которых голос хорошо говорит |
items[].isDefault | голос по умолчанию |
Аватары
GET /avatar/avatars - область tools:avatar. Все аватары, которые ваш аккаунт может использовать в POST /avatar/video: собственные, из фото и стандартные ведущие.
| Поле | Описание |
|---|---|
items[].avatarId | id для поля avatarId |
items[].name | название |
items[].kind | custom (обученный), photo (из фото) или standard |
items[].status | использовать можно только ready |
items[].gender | для стандартных ведущих |
items[].thumbnailUrl | миниатюра |
Собственный аватар создается в кабинете, в инструменте AI-аватара; через API - только использование готовых.
Музыка для видео
GET /video/music - область tools:video. Треки без роялти для поля musicTrackId.
| Поле | Описание |
|---|---|
items[].trackId | id трека |
items[].title, items[].artist | название и автор |
items[].license | лицензия |
items[].genre | жанр |
items[].durationSec | длительность |
items[].previewPath | прослушать: https://developers.grem.capital/api/v1 + previewPath (нужна область tools:artifacts) |
Финальные фразы для видео
GET /video/endings?language=en - область tools:video. Готовые финальные фразы на языке видео для POST /video/create и наибольшая длина своей фразы (ctaText).
| Поле | Описание |
|---|---|
language | язык фраз |
maxCustomChars | наибольшая длина своей фразы |
options | готовые фразы |
options[].intent | id фразы - передайте его в ctaIntent |
options[].text | фраза на запрошенном языке |
Доступность инструментов
GET /tools/status - любой ключ.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
Инструмент с available: false сейчас отвечает 503 service_unavailable и ничего не списывает. Проверяйте перед массовым запуском. Инструментов, которых нет в списке, проверка доступности не касается.
История работ
GET /works - любой ключ. Результаты вашего аккаунта во всех инструментах - и через API, и из кабинета, от новых к старым.
| Параметр | Описание |
|---|---|
tool | путь инструмента: valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Результаты фото, сайтов и черновиков в истории не хранятся |
status | фильтр по статусу |
limit | сколько на страницу, 1-50 (по умолчанию 20) |
cursor | nextCursor предыдущей страницы; другое значение - 400 |
from, to | созданные в эту дату или позже / в эту дату или раньше |
Известный параметр с недопустимым значением отклоняется с 400 validation и названием поля.
| Поле | Описание |
|---|---|
items[].id | id работы |
items[].tool | путь инструмента |
items[].status, items[].title, items[].language | статус, название, язык |
items[].city, items[].country | адрес объекта, если есть |
items[].street, items[].streetNumber | улица и номер дома, если есть |
items[].previewUrl, items[].link | превью и готовый PDF, если есть (скачивание через GET /artifacts/{path}); превью флаера - само изображение (data:image/...) |
items[].object | объект, для которого сделан результат: id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | сколько раз результат перегенерировали; общий текст, если задача завершилась сбоем |
items[].createdAt | когда создано |
nextCursor | для следующей страницы; null - страниц больше нет |