有些工具以 ID 作为输入：声音、数字人、曲目。这些 ID 通过本页的请求获取。全部是免费的 GET。
声音
GET /voices：任意密钥。用于 POST /video/create、POST /avatar/video 和内容包（form.voiceId）的配音声音。
curl "https://developers.grem.capital/api/v1/voices?language=zh" \
-H "Authorization: Bearer gsk_live_xxx"
language（可选）：ISO 639-1 代码，只保留会说该语言的声音。
| 字段 | 说明 |
|---|---|
items[].voiceId | 用于 voiceId 字段的 ID |
items[].name | 声音名称 |
items[].gender | male 或 female |
items[].description | 声音特点 |
items[].languages | 该声音擅长的语言 |
items[].isDefault | 默认声音 |
数字人
GET /avatar/avatars：权限范围 tools:avatar。您的账户可在 POST /avatar/video 中使用的所有数字人：自有的、照片生成的和标准主持人。
| 字段 | 说明 |
|---|---|
items[].avatarId | 用于 avatarId 字段的 ID |
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=zh：权限范围 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 表示没有更多页面 |