SurgeAI
  1. SurgeAI
SurgeAI
  • SurgeAI
    • SurgeAI核心优势
    • 快速开始
    • 认证
    • 如何使用
      • OpenClaw
      • Codex
      • 聊天应用
      • Claude Code
      • Dify
    • API参考
      • OpenAI
        • gpt-5
          • official-format
            • gpt-5 (网络搜索 (Response))
            • gpt-5 (文本转文本)
            • gpt-5 (文本转文本)
            • gpt-5 (图像转文本 (Chat))
            • gpt-5 (图像转文本 (Response))
            • gpt-5 (文件分析)
        • gpt-4o
          • official-format
            • gpt-4o (网络搜索 (Response))
            • gpt-4o (文本转文本 (Response))
            • gpt-4o (文本转文本 (Chat))
            • gpt-4o (图像转文本 (Chat))
            • gpt-4o (图像转文本 (Response))
            • gpt-4o (文件分析 (Response))
        • gpt-4.1
          • official-format
            • gpt-4.1 (联网搜索)
            • gpt-4.1 (文本转文本)
            • gpt-4.1 (文本转文本)
            • gpt-4.1 (图像分析)
            • gpt-4.1 (图像分析)
            • gpt-4.1 (文件分析)
      • Vidu
        • viduq3-pro
          • gptproto-format
            • viduq3-pro (Image To Video)
            • viduq3-pro (Text To Video)
        • viduq2-pro
          • gptproto-format
            • viduq2-pro (Image To Video)
            • viduq2-pro (Text To Video)
      • Suno
        • suno-music
          • official-format
            • official-format (查询任务)
            • official-format (文本转音频)
      • Midjourney
        • Midjourney
          • task-submission
            • midjourney (imagine)
          • task-query
            • midjourney (fetchfromtask)
      • Grok
        • grok-3
          • openai-format
            • grok-3 (文本转文本 (聊天))
        • grok-4
          • openai-format
            • grok-4 (文本转文本 (聊天))
      • DeepSeek
        • deepseek-v3.2
          • openai-format
            • deepseek-v3.2 (文本转文本)
      • Alibaba
        • qwen-plus
          • openai-format
            • qwen-plus (文本转文本)
        • qwen3-max
          • openai-format
            • qwen3-max (文本转文本)
        • wan-2.5-preview
          • gptproto-format
            • wan-2.5-preview (图片编辑)
            • wan-2.5-preview (查询任务)
            • wan-2.5-preview (图生视频)
            • wan-2.5-preview (文生图)
            • wan-2.5-preview (文生视频)
        • qwen-turbo
          • openai-format
            • qwen-turbo (文本转文本)
      • MiniMax
        • hailuo-02-pro
          • gptproto-format
            • hailuo-02-pro (图生视频)
            • hailuo-02-pro (文生视频)
      • Kling
        • kling-v2.1-pro
          • gptproto-format
            • kling-v2.1-pro (图生视频)
            • kling-v2.1-pro (文生视频)
        • kling-v3.0-pro
          • gptproto-format
            • kling-v3.0-pro (图生视频)
            • kling-v3.0-pro (文生视频)
      • Claude
        • claude-haiku-4-5-20251001
          • official-format
            • claude-haiku-4-5-20251001 (联网搜索)
            • claude-haiku-4-5-20251001 (文件分析)
            • claude-haiku-4-5-20251001 (文本生成)
          • openai-format
            • claude-haiku-4-5-20251001 (联网搜索)
            • claude-haiku-4-5-20251001 (文件分析)
            • claude-haiku-4-5-20251001 (文本生成)
      • Google
        • gemini-2.5-flash
          • official-format
            • gemini-2.5-flash (联网搜索)
            • gemini-2.5-flash (文件分析)
            • gemini-2.5-flash (文本生成)
            • gemini-2.5-flash (图像理解)
        • gemini-2.5-pro
          • official-format
            • gemini-2.5-pro (联网搜索)
            • gemini-2.5-pro (文件分析)
            • gemini-2.5-pro (文本生成)
            • gemini-2.5-pro (图像理解)
      • Runway
        • runwayml-gen3a_turbo-5
          • official-format
            • official-format (提交视频生成任务)
            • official-format (查询任务)
  1. SurgeAI

认证

了解如何对您的 API 请求进行认证

API Key 认证#

SurgeAI API 使用 Bearer 令牌认证。所有 API 请求必须在 Authorization 请求头中包含您的 API Key。

获取您的 API Key#

1.
在 https://surgeai.one 注册 SurgeAI 账号
2.
进入控制台的 API Keys 部分
3.
生成新的 API Key
4.
复制并安全存储您的 API Key
⚠️ 保护您的 API Key 安全
切勿将 API Key 提交到版本控制系统
不要公开分享您的 API Key
使用环境变量存储密钥
定期轮换密钥以增强安全性

发起认证请求#

在 Authorization 请求头中包含您的 API Key,并添加 Bearer 前缀:

cURL#

Python#

JavaScript#

Go#

环境变量#

推荐配置#

将您的 API Key 存储在环境变量中,而不是硬编码:
Linux/macOS
Windows PowerShell
$env:SURGEAI_API_KEY="your-api-key-here"
.env 文件

使用 .env 文件#

对于本地开发,使用 .env 文件:
Python (.env)
Node.js (.env)
⚠️ 始终将 .env 添加到 .gitignore 文件中,以防止意外提交密钥。

认证错误#

常见错误响应#

401 Unauthorized#

您的 API Key 缺失或无效。
{
  "error": {
    "message": "Invalid authentication credentials",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

403 Forbidden#

您的 API Key 没有权限访问此资源。
{
  "error": {
    "message": "You do not have access to this resource",
    "type": "permission_error",
    "code": "insufficient_permissions"
  }
}

429 Too Many Requests#

您已超出速率限制。
{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

最佳实践#

实践说明
使用环境变量始终将 API Key 存储在环境变量中,绝不要放在源代码中
实施密钥轮换定期轮换 API Key 以最小化安全风险。在撤销旧密钥之前生成新密钥并更新应用程序
不同环境使用不同密钥为开发、测试和生产环境使用单独的 API Key
监控使用情况定期在控制台检查 API 使用情况,以检测任何异常活动
实施速率限制实施客户端速率限制,避免触发 API 速率限制

API Key 管理#

生成新密钥#

1.
登录您的 控制台
2.
进入 API Keys
3.
点击 生成新密钥
4.
为密钥设置一个描述性名称
5.
立即复制密钥(之后将无法再次查看)

撤销密钥#

如果您怀疑 API Key 已泄露:
1.
进入您的 控制台
2.
在 API Keys 部分找到泄露的密钥
3.
点击 撤销
4.
生成新密钥并更新您的应用程序
💡 设置密钥过期策略,以在指定时间后自动轮换密钥。

支持#

如果您遇到认证问题:
检查 API Key 格式是否正确
验证密钥是否已被撤销
确保您使用的是正确的 API 端点
联系 support@surgeai.one 获取帮助
修改于 2026-03-11 06:24:05
上一页
快速开始
下一页
OpenClaw
Built with