快速开始

认证方式

创建您的 API 密钥

在开始之前, 您需要一个 API 密钥. 前往设置页面创建一个.

第一步：点击”创建 API 密钥”按钮

第二步：为您的 API 密钥起一个描述性的名称

第三步：保存并复制生成的 API 密钥（仅显示一次）

使用您的 API 密钥

在每个 API 请求的 Authorization 请求头中包含您的 API 密钥：

Authorization: Bearer YOUR_API_KEY

API 密钥安全最佳实践

使用环境变量： 将 API 密钥存储在环境变量中, 永远不要硬编码在源代码中

仅服务器端： 始终从后端进行 API 调用, 永远不要直接从浏览器或移动应用调用

定期轮换： 定期轮换您的 API 密钥, 特别是在怀疑它们可能已被泄露时

最小权限： 为不同的应用程序创建单独的 API 密钥, 以便于管理和撤销

如果您认为您的 API 密钥已被泄露, 请立即在设置中撤销它并创建新的密钥.

使用 LLM 模型（文本聊天）

与任何 LLM 模型聊天. 以下是完整的代码示例：

curl 'https://cloud.vtrix.ai/llm/chat/completions' \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -H 'Content-Type: application/json' \
 -d '{ 
 	"model": "vtrix-gpt-5", 
 	"messages": [{"role":"user","content":"hello"}] 
 }'

使用 AI 智能体（专业能力）

AI 智能体是具有工具调用和多模态能力的专业 AI 助手：

curl https://cloud.vtrix.ai/agent/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $YOUR_API_KEY" \
-H "X-Project: Vtrix" \
-d '{
  "agent_id": "seagen_agent",
  "model":"vtrix-gpt-4.1",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hello, please introduce yourself."
        }
      ]
    }
  ]
}'

访问 Agent Studio 浏览可用的智能体, 或查看 Agent API 文档了解详细用法.

使用多模态模型（图像生成）

使用 Google Gemini 3 Pro Image 生成图像. 此示例展示如何调用多模态模型：

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "model": "google_gemini3_pro_image",
  "input": [
    {
      "params": {
        "prompt": "example_prompt",
        "image_urls": [
          "https://example.com/image.jpg"
        ],
        "aspect_ratio": "1:1",
        "resolution": "1K"
      }
    }
  ]
}'