从注册到首次调用

注册登录

创建账号后进入控制台，确认账户状态、余额和基础资料显示正常。建议使用强密码并定期更换。

充值余额

按业务量预估充值。文本模型关注 token，图像视频模型关注规格、张数、分辨率和时长。

申请令牌

在令牌页面创建 API Key，按项目、环境或业务线拆分令牌，便于统计和停用。

环境变量配置

不要把密钥写死到代码里。生产环境建议通过环境变量、密钥管理系统或服务端配置注入。

GITAAA_BASE_URL=https://api.gitaaa.com/v1
GITAAA_API_KEY=YOUR_GITAAA_TOKEN

首次调用

先用低成本模型做连通性测试，再切换到业务模型。保留 request id 方便排查。

curl https://api.gitaaa.com/v1/chat/completions \
  -H "Authorization: Bearer $GITAAA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"ping"}]}'

生产环境建议

设置超时、重试退避、并发限制、余额告警和调用日志。异步任务需要保存任务 ID 并处理失败状态。