Rightis

rightis-js

在代码生成人物的真实面孔、声音或人设之前，请先使用此工具。 对于图像、视频和语音模型、人脸替换、声音克隆、AI 虚拟形象，以及真实人物或已注册角色的聊天人设，请先在服务器上向 Rightis 查询，再调用生成接口。

Rightis 是一个公开的身份权利登记库。个人和权利持有人可以登记自己的肖像，并说明允许、希望审核或拒绝哪些 AI 用途。本仓库提供 JavaScript SDK 和命令行工具。

软件包	路径	内容
@rightis/sdk	packages/sdk	类型化客户端：权利检查、许可、使用情况、Webhook 验证
rightis	packages/cli	npx rightis：从终端检查、登录、获取沙盒密钥

30 秒快速入门

npm install @rightis/sdk
npx rightis check BR-XXXX-XXXX-XXXX --use "instagram ad" --asset face --public

import { Rightis } from '@rightis/sdk';

const rightis = new Rightis(); // server only; reads RIGHTIS_SECRET_KEY, keyless without it
const result = await rightis.rights.check({
  rights_id: 'BR-XXXX-XXXX-XXXX',
  use_type: 'instagram ad',
  ai_methods: ['image_generation'],
  asset_types: ['face'],
  territory: ['US'],
});
console.log(result.decision, result.next_action.type, result.next_action.url);

请查看 next_action，不要只看 decision：

decision	next_action.type	含义
allowed	request_license	已预先批准的范围。并非免费使用：如果费用达到权利持有人设定的最低标准，许可申请无需经其审核即可获批。仍需提出申请。
requires_approval	request_license	权利持有人会逐一决定每项申请。
unspecified	request_license	权利持有人尚未表态。这不代表同意。
denied	stop	已拒绝。请勿生成。
null	not_registered	未登记在注册库中。不代表已获许可。
null	describe_use	已登记，但未说明用途。请添加 use_type、ai_methods、asset_types。

查询失败不等于“未登记”：出现任何 RightisError 时，请勿生成。SDK 特意没有提供将决策转成“可以继续”的布尔值。

只有姓名？rightis.rights.search('name') 会返回已公开的登记信息及其 Rights ID。未找到匹配项不代表已获许可。

面向 AI 编码助手

• Claude Code 技能：skills/rightis/SKILL.md。将其复制到项目中的 .claude/skills/rightis/SKILL.md（或 ~/.claude/skills/rightis/）。
• Cursor 规则： .cursor/rules/rightis.mdc。将其复制到项目中的 .cursor/rules/。
• Codex 和其他 Agent：AGENTS.md，其中包含可粘贴到你自己的 AGENTS.md 或 CLAUDE.md 中的代码片段。
• 无需密钥的 MCP 服务：https://rightis.org/api/public-mcp/mcp（rights_lookup、rights_search、registry_info）。

链接

• 开发者文档：https://rightis.org/en/developers
• 指南：生成真实人物：https://rightis.org/en/developers/guides/real-person-likeness
• SDK 参考文档：packages/sdk/README.md
• CLI 参考文档：packages/cli/README.md

沙盒

npx rightis login                                   # browser sign-in (OAuth with PKCE)
npx rightis init                                    # sandbox key into .env.local, plus an example file
npx rightis people                                  # the sandbox sample people
npx rightis check BR-SANDBOX-... --use "social media ad" --asset face
node --env-file=.env.local rightis-example.mjs      # the same check from code

开发

pnpm install
pnpm -r build
pnpm -r test
pnpm -r typecheck

Node 20 或更高版本。使用 RIGHTIS_API_URL=http://localhost:3000（或 --base-url）将 SDK 和 CLI 指向本地服务。

从 packages/sdk 运行 pnpm publish --access public，然后在 packages/cli 中运行。请勿使用 npm publish：只有 pnpm 会重写 CLI 的 workspace:^ 依赖。

许可证

MIT，The Backers Inc.