Skip to main content
GET
列出角色
返回当前账户最近创建的有效角色,按创建时间从新到旧排列。角色就绪后,可在 POST /v1/renders 中使用返回的 id

请求参数

GET /v1/characters 没有路径、查询或请求体参数。发送 Authorization: Bearer YOUR_API_KEY

响应参数

返回 200 OK。最多返回 100 条,无游标,无法通过本接口访问更早的角色。

示例

授权

Authorization
string
header
必填

服务端 SDK 使用项目 API 密钥,Remote MCP 使用 OAuth 访问令牌。不要在浏览器代码中暴露项目密钥。

请求头

X-Request-Id
string

可选的调用者自定义关联 ID,最长 128 字符。服务会在响应头返回实际使用的值,便于追踪和支持排查。

Required string length: 1 - 128
X-Viggle-Source
string

可选来源标签,最长 128 字符,用于识别 SDK、集成、产品入口或内部工作流。

Required string length: 1 - 128

响应

请求成功。

无分页游标的结果集。最多返回最近 100 个素材,从新到旧,无法通过此接口访问更早的条目。

data
object[]
必填

当前调用者最多 100 个有效素材,按创建时间从新到旧排列。