API 文档与快速接入

三步完成接入

API 鉴权

在请求头中使用 Authorization: Bearer YOUR_API_KEY。不要在浏览器前端、公共仓库或日志中暴露密钥。

发起请求

以下为接入示例，接口域名与可用模型将在正式开通时确认。

curl https://api.tokenforge.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[
    {"role":"user","content":"Hello TokenForge"}
  ]}'

兼容格式

请求结构兼容常见 Chat Completions 调用方式，便于现有项目平滑迁移。

模型路由

可按模型能力、延迟、成本和可用状态选择调用路线。模型名称只用于说明兼容范围，不代表官方合作关系。

错误处理

建议对超时、额度不足、模型不可用和频率限制做指数退避与明确日志记录。企业接入可进一步配置白名单和故障切换策略。

接入指南

准备预计调用量、峰值并发、目标模型、部署区域和结算方式，联系技术顾问后完成账户、密钥和路由配置。