Деякі інструменти приймають ідентифікатори: голос, аватар, трек. Їх беруть із запитів на цій сторінці. Усі вони - 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 - сторінок більше немає |