Skip to content

API 认证 ​

区分模型调用 Token、个人资料访问令牌与查询授权 Token,并安全传递认证信息

API 认证 ​

Fhddos 常见令牌分为三类,不能混用:

令牌类型主要用途常见路径
模型调用 Token调用模型与供应商兼容接口/v1/*、/minimaxi/*、/kling/*、/vidu/*
个人资料访问令牌查询账号资料、余额等控制台数据/api/user/*
查询授权 Token只读查询余额、日志、任务和运营数据/api/query/v1/*

模型调用 Token ​

模型调用 Token 用于实际模型请求。调用时通过 Authorization header 传递:

bash
curl "https://aiapi.fhddos.com/v1/models" \
  -H "Authorization: Bearer $TOKEN"

WARNING

模型调用 Token 应只保存在服务端或可信运行环境,不要放进浏览器前端、移动端包体或公开仓库。

个人资料访问令牌 ​

个人资料访问令牌用于查询账号相关数据,例如余额:

bash
curl "https://aiapi.fhddos.com/api/user/balance" \
  -H "Authorization: Bearer $PROFILE_TOKEN"

更多余额字段说明见 账号余额查询 API。

查询授权 Token ​

查询授权 Token 用于把只读数据查询能力开放给外部系统,密钥以 qak- 开头。可读范围分为当前用户、指定用户、全部用户:

bash
curl "https://aiapi.fhddos.com/api/query/v1/logs?time_preset=24h" \
  -H "Authorization: Bearer $QUERY_TOKEN"

更多权限、请求字段和响应字段见 查询授权。

建议做法 ​

  • 为不同业务系统创建不同 Token,便于权限控制和故障隔离。
  • 在服务端环境变量或密钥管理系统中保存 Token。
  • 生产环境记录 请求 ID,便于排查问题。
  • Token 泄露后应立即在控制台禁用或重置。

Fhddos AI 用户文档