97AI.PRO API 快速上手(重要)
欢迎使用 97AI.PRO。本指南将带你了解把 97AI.PRO API 集成到你的产品所需的核心信息,包括模型、价格、鉴权、请求流程、限制以及支持渠道。
我们力求透明、实用、对开发者友好。上线生产前请仔细阅读本页。
1. 可用模型与 Playground
你可以在模型市场页面查看最新支持的模型:👉 /market
一旦新模型稳定,我们就会持续更新并接入。
每个模型页面都链接到它的 Playground,你可以在调用 API 之前直接在界面里测试和试验。Playground 是理解模型行为、参数和输出格式的最佳位置。
2. 价格
3. 创建并保护你的 API 密钥
在这里创建和管理你的 API 密钥:👉 /api-keys
重要安全提示:
- 切勿在前端代码(浏览器、移动端 App、公开仓库)中暴露你的 API 密钥。
- 请把 API 密钥当作机密对待。
为帮助保护你的使用,我们提供:
- 按密钥的速率限制(小时、每日以及总用量上限)
- IP 白名单支持,只允许获批的服务器 IP 访问 API
4. 必需的请求头
每个 API 请求都必须包含正确的请求头:
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json如果缺少或填写错误,你可能会收到:
{"error":"Please log in or provide an API key"}5. 日志与任务详情
你可以在这里查看所有历史任务:👉 /logs
每个任务都可查看:创建时间、所用模型、输入参数、任务状态、积分消耗,以及最终结果或错误详情。
6. 数据保留政策
- 生成的媒体文件:保存 14 天,之后自动删除
- 日志记录(文本 / 元数据):保存 2 个月,之后自动删除
如需长期保存,请及时在你这一侧下载并存储结果。
7. 异步任务模型
97AI.PRO 上的所有生成任务都是异步的。成功的 POST /api/generate 会返回 HTTP 200、一个 taskId 和 state: "waiting"。
这只表示任务已被接受,并不代表已完成。请每隔几秒轮询 GET /api/generate/{taskId},直到 state 变为 success 或 fail。对话请求(POST /api/chat)是同步的,直接返回回复。
8. 限制与合理使用
- 目前中转层没有严格的速率或并发限制。
- 发起任务需要持有最低余额(默认 50 积分),任务完成后按实际成本结算。
- 失败任务不计费。
请合理调用——滥用流量可能会被限速。如需保障高并发吞吐,请通过社区联系我们。
9. 开发者支持
在社区提问和反馈——这是联系我们和其他开发者最快的方式。
你也可以发邮件到 [email protected]。反馈生成失败时,请附上 taskId。
10. 稳定性预期
我们以极具竞争力的价格提供顶级 API 接入。整体稳定性可能略低于官方供应商——这是我们有意识的取舍。实际使用中,97AI.PRO 足够稳定,能够支撑生产级工作负载和长期业务增长。
11. 关于团队
97AI.PRO 由一个小型创业团队打造。我们行动迅速、非常在意开发者体验,并持续改进。你的反馈能帮助我们变得更好——我们由衷感谢。