API 文档

快速开始

把 SDK 的 Base URL 改为 Gitaaa Api，并使用你在令牌页创建的 API Key。OpenAI 兼容项目通常不需要改业务代码。

https://api.gitaaa.com/v1

Content-Type: application/json

application/json

认证与鉴权

所有模型调用都需要在请求头携带 Bearer Token。请只在服务端保存令牌，不要写入前端页面、公开仓库或客户端安装包。

Authorization: Bearer YOUR_GITAAA_TOKEN

模型列表

模型市场会展示当前可用模型、供应商、分类与计费规格。接口调用时使用模型 ID。

curl https://api.gitaaa.com/v1/models \
  -H "Authorization: Bearer YOUR_GITAAA_TOKEN"

聊天补全

适用于通用对话、代码、结构化输出、文本分析等场景。不同模型可能存在上下文长度和输出限制。

curl https://api.gitaaa.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_GITAAA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-8","messages":[{"role":"user","content":"你好"}]}'

流式响应

需要边生成边展示时，在请求体中设置 stream: true。客户端按 SSE 事件逐段读取内容。

{
  "model": "gpt-4o",
  "stream": true,
  "messages": [{"role": "user", "content": "写一段欢迎语"}]
}

图像生成

图像模型通常按张数、尺寸、质量或规格计费，调用前请在定价页核对该模型的规格。

curl https://api.gitaaa.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_GITAAA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3-pro-image-preview","prompt":"未来感 API 控制台"}'

同步任务 / 异步任务

文本类接口通常同步返回；视频、长任务或部分图像增强能力可能采用异步任务。提交任务后保存任务 ID，并通过查询接口轮询状态。

POST /v1/tasks
GET  /v1/tasks/{task_id}

计费与用量

文本模型按输入/输出 token 计费；图像、视频、音频模型按规格、秒数、张数或请求次数计费。最终扣费以账单记录为准。

错误码