AstraFlow

学完本教程，你将能够

• 在一个统一平台发现并比较超过 100 个文本、视觉、语音与多模态 AI 模型
• 通过 API 调用所选模型，无需自行部署或管理基础设施
• 根据响应速度、价格、准确率等指标，为你的应用选择最优模型
• 快速切换模型进行 A/B 测试，无需修改代码

前置条件

• 一个有效的 AstraFlow 账户（注册地址：https://astraflow.ucloud-global.com/en-us/signup）
• 一个已激活的 API Key（创建位置：控制台 → API Keys → 创建新密钥）
• 基本的 REST API 调用知识（HTTP 方法、请求头、JSON 格式）
• 用于测试的编程环境（cURL、Postman 或任意编程语言均可）

分步操作：发现、比较与调用 AI 模型

第一步：浏览模型目录

1. 登录 AstraFlow 控制台，进入 Models 页面。
2. 页面默认展示所有可用模型，按类别分为四栏：

• Text（文本生成、翻译、摘要）
• Vision（图像识别、目标检测、OCR）
• Speech（语音转文字、文字转语音、说话人识别）
• Multimodal（图文理解、视频分析、跨模态检索）

3. 使用顶部的筛选器缩小范围，例如：

• 按 Provider 筛选（如 OpenAI、Google、Anthropic、本地开源模型）
• 按 Pricing 筛选（免费、按量付费、订阅制）
• 按 Latency 筛选（低延迟 < 200ms、中延迟 200-1000ms、高延迟 > 1s）

第二步：比较模型详情

1. 点击任意模型卡片，进入详情页。
2. 在详情页中，你将看到以下关键信息（以表格形式呈现）：

3. 点击 Compare 按钮，最多可同时选择 4 个模型进行横向对比。
4. 对比页面会以表格形式并列展示各模型的上述字段，并额外显示：

• Benchmark Scores（如 MMLU、HellaSwag、HumanEval）
• Rate Limits（每分钟请求数、每日请求数）
• Supported Modalities（支持的输入输出格式）

第三步：调用模型（API 方式）

1. 在模型详情页，点击 Get API Endpoint 按钮，复制生成的 cURL 命令。
2. 打开终端或 Postman，执行以下示例请求（以文本模型为例）：

curl -X POST https://api.astraflow.ucloud-global.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-2024-08-06",
    "messages": [
      {"role": "system", "content": "你是一个专业的中文助手。"},
      {"role": "user", "content": "请用中文解释量子计算的基本原理。"}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'

3. 预期响应格式（JSON）：

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1723456789,
  "model": "gpt-4o-2024-08-06",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "量子计算利用量子比特（qubit）的叠加态和纠缠态进行并行计算..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 128,
    "total_tokens": 160
  }
}

第四步：切换模型进行测试

1. 在 API 请求中，将 model 字段的值替换为另一个模型的 ID（例如 claude-3-5-sonnet-20241022）。
2. 保持其他参数不变，发送请求。
3. 比较两次响应的质量、速度与成本。AstraFlow 控制台的 Usage 页面会记录每次调用的详细数据，包括：

• 调用时间
• 模型名称
• 输入/输出 tokens 数
• 实际花费
• 响应延迟

常见问题与排查

问题 1：API 返回 401 Unauthorized

• 原因：API Key 无效或已过期。
• 解决：在控制台重新生成 API Key，并确保在请求头中正确传递。

问题 2：模型调用返回 429 Too Many Requests

• 原因：超出当前模型的速率限制。
• 解决：
• 查看模型详情页的 Rate Limits 字段，了解具体限制。
• 在请求中增加指数退避重试逻辑。
• 考虑升级账户以获得更高配额。

问题 3：响应内容不符合预期（如语言错误、输出截断）

• 原因：
• 未正确设置 system 消息中的语言指令。
• max_tokens 设置过小导致输出被截断。
• 解决：
• 在 system 消息中明确指定语言（例如 "content": "你是一个专业的中文助手，请始终用中文回答。"）。
• 增大 max_tokens 值（最大不超过模型详情页显示的 Max Tokens）。

问题 4：无法找到特定模型

• 原因：模型可能已下架或仅对特定账户开放。
• 解决：
• 在控制台 Models 页面使用搜索框直接输入模型名称。
• 联系支持团队（support@astraflow.ucloud-global.com）确认模型可用性。