获取 API

创建一个 API Key，用它调用幻维的角色对话接口。Key 只与你的账号绑定，随时可撤销。

第 1 步

登录账号

API Key 绑定在账号上，用量与额度也按账号统计。

第 2 步

创建 Key

建议按用途命名（如「线上服务」「本地调试」），便于区分。

第 3 步

调用接口

把 Key 放进 Authorization 头即可，示例见下方。

curl -X POST http://localhost:3000/api/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{"message":"你好","character_id":"char_xxx"}'

鉴权

每个请求带上 Authorization: Bearer hw-chr-…。Key 等同于账号凭证，不要写进前端代码或提交到仓库，建议放在服务端环境变量里。

调用限制

默认每分钟 30 次，超出返回 429 并带 Retry-After；单条消息上限 500 字。角色 ID 见角色库，完整接口说明见 API 文档。

获取 API

登录账号

创建 Key

调用接口

鉴权

调用限制

产品

开发者

资源