Bazı araçlar girdi olarak kimlik alır: bir ses, bir avatar, bir parça. Bunları bu sayfadaki isteklerle alırsınız. Hepsi ücretsiz GET istekleridir.
Sesler
GET /voices: herhangi bir anahtar. POST /video/create, POST /avatar/video ve içerik paketi (form.voiceId) için seslendirme sesleri.
curl "https://developers.grem.capital/api/v1/voices?language=tr" \
-H "Authorization: Bearer gsk_live_xxx"
language (isteğe bağlı): ISO 639-1 kodu; o dili konuşan sesleri bırakır.
| Alan | Açıklama |
|---|---|
items[].voiceId | voiceId alanı için kimlik |
items[].name | ses adı |
items[].gender | male veya female |
items[].description | sesin karakteri |
items[].languages | sesin iyi konuştuğu diller |
items[].isDefault | varsayılan ses |
Avatarlar
GET /avatar/avatars: tools:avatar kapsamı. Hesabınızın POST /avatar/video içinde kullanabileceği tüm avatarlar: kendi avatarlarınız, fotoğraftan oluşturulanlar ve standart sunucular.
| Alan | Açıklama |
|---|---|
items[].avatarId | avatarId alanı için kimlik |
items[].name | ad |
items[].kind | custom (eğitilmiş), photo (fotoğraftan) veya standard |
items[].status | yalnızca ready kullanılabilir |
items[].gender | standart sunucularda |
items[].thumbnailUrl | küçük resim |
Kendi avatarınızı panelde, yapay zekâ avatar aracında oluşturursunuz; API üzerinden yalnızca hazır olanlar kullanılır.
Video için müzik
GET /video/music: tools:video kapsamı. musicTrackId alanı için telifsiz parçalar.
| Alan | Açıklama |
|---|---|
items[].trackId | parça kimliği |
items[].title, items[].artist | ad ve sanatçı |
items[].license | lisans |
items[].genre | tür |
items[].durationSec | süre |
items[].previewPath | dinleme: https://developers.grem.capital/api/v1 + previewPath (tools:artifacts kapsamı gerekir) |
Video için kapanış cümleleri
GET /video/endings?language=tr: tools:video kapsamı. POST /video/create için video dilinde hazır kapanış cümleleri ve kendi cümlenizin (ctaText) en fazla uzunluğu.
| Alan | Açıklama |
|---|---|
language | cümlelerin dili |
maxCustomChars | kendi cümlenizin en fazla uzunluğu |
options | hazır cümleler |
options[].intent | cümle kimliği: ctaIntent olarak gönderin |
options[].text | istenen dilde cümle |
Araçların kullanılabilirliği
GET /tools/status: herhangi bir anahtar.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
available: false olan bir araç şu anda 503 service_unavailable ile yanıt verir ve ücret almaz. Toplu bir çalıştırmadan önce kontrol edin. Listede olmayan araçların kullanılabilirlik kontrolü yoktur.
Çalışma geçmişi
GET /works: herhangi bir anahtar. Hesabınızın tüm araçlardaki sonuçları, hem API üzerinden hem panelden, en yeniler önce.
| Parametre | Açıklama |
|---|---|
tool | araç yolu: valuation/report, valuation/rent, valuation/review, content/generate, video/create, text/generate, pdf/create, floorplan/create, avatar/video, flyer/create, tour. Fotoğraf, site ve taslak sonuçları geçmişte tutulmaz |
status | durum filtresi |
limit | sayfa başına öğe, 1-50 (varsayılan 20) |
cursor | önceki sayfanın nextCursor değeri; başka bir değer: 400 |
from, to | bu tarihte veya sonrasında / bu tarihte veya öncesinde oluşturulanlar |
Bilinen bir parametre geçersiz bir değerle gelirse alan adını belirten 400 validation ile reddedilir.
| Alan | Açıklama |
|---|---|
items[].id | sonucun kimliği |
items[].tool | araç yolu |
items[].status, items[].title, items[].language | durum, başlık, dil |
items[].city, items[].country | varsa ilan adresi |
items[].street, items[].streetNumber | varsa sokak ve bina numarası |
items[].previewUrl, items[].link | varsa önizleme görseli ve bitmiş PDF (GET /artifacts/{path} ile indirilir); flyer önizlemesi görselin kendisidir (data:image/...) |
items[].object | sonucun yapıldığı ilan: id, kind, name, isDraft, photoUrl |
items[].repeatIndex, items[].error | kaç kez yeniden üretildiği; iş başarısız olduysa genel bir metin |
items[].createdAt | oluşturulma zamanı |
nextCursor | sonraki sayfa için; null, başka sayfa yok |