Bəzi alətlər giriş kimi identifikatorlar qəbul edir: səs, avatar, trek. Onları bu səhifədəki sorğularla alırsınız. Hamısı pulsuz GET sorğularıdır.
Səslər
GET /voices - istənilən açar. POST /video/create, POST /avatar/video və kontent paketi (form.voiceId) üçün səsləndirmə səsləri.
curl "https://developers.grem.capital/api/v1/voices?language=de" \
-H "Authorization: Bearer gsk_live_xxx"
language (istəyə bağlı) - ISO 639-1 kodu: yalnız bu dildə danışan səsləri saxlayır.
| Sahə | Təsvir |
|---|---|
items[].voiceId | voiceId sahəsi üçün identifikator |
items[].name | səsin adı |
items[].gender | male və ya female |
items[].description | səsin xarakteri |
items[].languages | səsin yaxşı danışdığı dillər |
items[].isDefault | standart səs |
Avatarlar
GET /avatar/avatars - tools:avatar icazəsi. Hesabınızın POST /avatar/video sorğusunda istifadə edə biləcəyi bütün avatarlar: öz avatarlarınız, fotoya əsaslananlar və standart aparıcılar.
| Sahə | Təsvir |
|---|---|
items[].avatarId | avatarId sahəsi üçün identifikator |
items[].name | ad |
items[].kind | custom (öyrədilmiş), photo (fotodan) və ya standard |
items[].status | yalnız ready istifadə oluna bilər |
items[].gender | standart aparıcılar üçün |
items[].thumbnailUrl | miniatür |
Öz avatarınızı kabinetdə, Aİ avatar alətində yaradırsınız; API vasitəsilə yalnız hazır avatarlardan istifadə edirsiniz.
Video üçün musiqi
GET /video/music - tools:video icazəsi. musicTrackId sahəsi üçün müəllif haqqı ödənişsiz treklər.
| Sahə | Təsvir |
|---|---|
items[].trackId | trekin identifikatoru |
items[].title, items[].artist | ad və ifaçı |
items[].license | lisenziya |
items[].genre | janr |
items[].durationSec | müddət |
items[].previewPath | dinləmək: https://developers.grem.capital/api/v1 + previewPath (tools:artifacts icazəsi tələb olunur) |
Video üçün yekun ifadələr
GET /video/endings?language=en - tools:video icazəsi. POST /video/create üçün video dilində hazır yekun ifadələr və öz ifadənizin (ctaText) maksimal uzunluğu.
| Sahə | Təsvir |
|---|---|
language | ifadənin dili |
maxCustomChars | öz ifadənizin maksimal uzunluğu |
options | hazır ifadələr |
options[].intent | ifadənin identifikatoru - onu ctaIntent kimi ötürün |
options[].text | tələb olunan dildə ifadə |
Alətlərin əlçatanlığı
GET /tools/status - istənilən açar.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
available: false olan alət hazırda 503 service_unavailable ilə cavab verir və ödəniş tutmur. Kütləvi işə salmadan əvvəl bunu yoxlayın. Siyahıda olmayan alətlər üçün əlçatanlıq yoxlaması yoxdur.
İş tarixçəsi
GET /works - istənilən açar. Hesabınızın bütün alətlər üzrə nəticələri - həm API vasitəsilə, həm də kabinetdən, ən yenilər birinci.
| Parametr | Təsvir |
|---|---|
tool | alətin yolu: valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Foto, sayt və qaralama nəticələri tarixçədə saxlanılmır |
status | status filtri |
limit | səhifədəki element sayı, 1-50 (standart 20) |
cursor | əvvəlki səhifədən nextCursor; başqa dəyər - 400 |
from, to | bu tarixdə və ya ondan sonra / bu tarixdə və ya ondan əvvəl yaradılıb |
Məlum parametrin yanlış dəyəri sahənin adı göstərilməklə 400 validation ilə rədd edilir.
| Sahə | Təsvir |
|---|---|
items[].id | işin identifikatoru |
items[].tool | alətin yolu |
items[].status, items[].title, items[].language | status, ad, dil |
items[].city, items[].country | obyektin ünvanı, varsa |
items[].street, items[].streetNumber | küçə və ev nömrəsi, varsa |
items[].previewUrl, items[].link | önizləmə şəkli və hazır PDF, varsa (GET /artifacts/{path} ilə yükləyin); flayerin önizləməsi şəklin özüdür (data:image/...) |
items[].object | nəticənin hazırlandığı obyekt: id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | neçə dəfə yenidən yaradılıb; tapşırıq uğursuz olduqda ümumi mətn |
items[].createdAt | yaradılma vaxtı |
nextCursor | növbəti səhifə üçün; null - başqa səhifə yoxdur |