# API 参考 (/docs/api)





## 概述 [#概述]

疾旋Token 开放平台提供标准 RESTful API 接口，分为 **AI 模型接口** 和 **用户与平台接口** 两大类。

* **AI 模型接口**：完全兼容 OpenAI、Anthropic Claude、Google Gemini 官方请求格式，直连 `GPT-5.6-sol`、`GPT-5.6-terra`、`GPT-5.6-luna` 等旗舰模型。
* **用户与平台接口**：提供个人令牌管理、账号信息与邀请返利、充值记录查询、使用日志分析与消费统计等能力。

<Callout type="info" title="接口调用基础信息">
  - **API Base URL**：`https://token.astrumflow.com/v1`（根域名 `https://token.astrumflow.com`）
  - **鉴权方式**：在请求头中添加 `Authorization: Bearer sk-your-astrumflow-token-key`
  - **内容格式**：请求与响应均采用 `application/json; charset=utf-8`
</Callout>

***

## AI 模型接口 [#ai-模型接口]

提供全套多模态 AI 能力调用，覆盖对话、文本补全、嵌入向量、文档重排、语音、图像与视频生成。

<Cards>
  <Card icon="<MessageSquare />" title="聊天补全 (Chat)" description="支持流式（SSE）与非流式对话响应，兼容 OpenAI / Claude / Gemini 多种格式。" href="/docs/api/ai-model/chat/openai/createchatcompletion" />

  <Card icon="<List />" title="模型列表 (Models)" description="查询当前令牌有权调用的可用大模型完整清单与规格。" href="/docs/api/ai-model/models/list/listmodels" />

  <Card icon="<Database />" title="文本嵌入 (Embeddings)" description="高质量高维向量化接口，适用于 RAG 检索与知识库构建。" href="/docs/api/ai-model/embeddings/createembedding" />

  <Card icon="<Search />" title="文档重排序 (Rerank)" description="对初步召回的文档列表进行二次相关性重排打分。" href="/docs/api/ai-model/rerank/creatererank" />

  <Card icon="<Headphones />" title="语音音频 (Audio)" description="包含文本转语音（TTS）、语音转写（STT）与语音翻译接口。" href="/docs/api/ai-model/audio/openai/createspeech" />

  <Card icon="<Radio />" title="实时语音流 (Realtime)" description="低延迟端到端双向实时语音交互 Session 建立。" href="/docs/api/ai-model/realtime/createrealtimesession" />

  <Card icon="<Image />" title="图像生成 (Images)" description="多尺寸高保真 AI 绘画、图像编辑与变体生成接口。" href="/docs/api/ai-model/images/openai/post-v1-images-generations" />

  <Card icon="<Video />" title="视频生成 (Videos)" description="支持文生视频与图生视频任务创建与状态轮询。" href="/docs/api/ai-model/videos/kling/createklingtext2video" />

  <Card icon="<FileText />" title="传统文本补全 (Completions)" description="兼容经典单轮文本续写与代码补全接口。" href="/docs/api/ai-model/completions/createcompletion" />

  <Card icon="<ShieldCheck />" title="内容审查 (Moderations)" description="多维度文本敏感内容合规安全审核接口。" href="/docs/api/ai-model/moderations/createmoderation" />
</Cards>

***

## 用户与平台接口 [#用户与平台接口]

用于个人账户维护、密钥分配、账单核对与日志追踪的普通用户接口。

<Cards>
  <Card icon="<Users />" title="个人账号信息 (User Profile)" description="获取当前用户信息、用户可用模型列表与当前用户分组。" href="/docs/api/management/user-management/user-self-get" />

  <Card icon="<Share2 />" title="邀请与返利 (Affiliate)" description="获取专属邀请码链接，或将邀请返利额度一键转换为可用余额。" href="/docs/api/management/user-management/user-aff-get" />

  <Card icon="<Key />" title="访问令牌管理 (Tokens)" description="创建、查询、更新或删除您的个人 API 访问密钥与额度限制。" href="/docs/api/management/token-management/token-get" />

  <Card icon="<CreditCard />" title="充值与记录 (Billing)" description="获取充值配置信息与个人历史充值入账记录。" href="/docs/api/management/payment/user-topup-info-get" />

  <Card icon="<ScrollText />" title="使用日志 (Logs)" description="按时间、模型、令牌检索个人详细调用流水与 Token 消耗。" href="/docs/api/management/logs/log-self-get" />

  <Card icon="<ChartBar />" title="消费统计 (Statistics)" description="汇总查询个人账号在不同时间周期的消费走势与用量分布。" href="/docs/api/management/statistics/data-self-get" />

  <Card icon="<Info />" title="系统可用模型 (System Models)" description="免鉴权获取平台全局开放的模型清单与费率乘数。" href="/docs/api/management/system/models-get" />

  <Card icon="<Bell />" title="系统公告 (Notice)" description="获取平台最新维护通知、上新动态与公告信息。" href="/docs/api/management/system/notice-get" />

  <Card icon="<ListTodo />" title="异步生成任务 (Tasks)" description="查询 Midjourney 等耗时异步任务的执行状态与结果。" href="/docs/api/management/tasks/task-self-get" />
</Cards>