快速开始

在5分钟内完成您的第一次API调用，开始使用aiapi.services强大的AI能力。

步骤 1: 获取API密钥

访问 aiapi.services控制台
注册或登录您的账户
在”API密钥”页面点击”创建新密钥”
复制您的API密钥（格式: sk-...）

⚠️ 保护您的API密钥: 请勿在客户端代码或公共仓库中暴露API密钥。将密钥存储在环境变量或安全的配置文件中。

步骤 2: 发送您的第一个请求

cURL


curl https://aiapi.services/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {
        "role": "user",
        "content": "你好！请介绍一下你自己。"
      }
    ]
  }'

Python


import requests
 
response = requests.post(
  'https://aiapi.services/v1/chat/completions',
  headers={
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  json={
    'model': 'gemini-2.5-flash',
    'messages': [
      {
        'role': 'user',
        'content': '你好！请介绍一下你自己。'
      }
    ]
  }
)
 
data = response.json()
print(data['choices'][0]['message']['content'])

JavaScript


const response = await fetch('https://aiapi.services/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash',
    messages: [
      {
        role: 'user',
        content: '你好！请介绍一下你自己。'
      }
    ]
  })
});
 
const data = await response.json();
console.log(data.choices[0].message.content);

Go


package main
 
import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  url := "https://aiapi.services/v1/chat/completions"
 
  payload := map[string]interface{}{
    "model": "gemini-2.5-flash",
    "messages": []map[string]string{
      {"role": "user", "content": "你好！请介绍一下你自己。"},
    },
  }
 
  jsonData, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
 
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
 
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

步骤 3: 理解响应

成功的请求将返回以下JSON响应:


{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gemini-2.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是一个AI助手，很高兴为您服务。我可以帮助您回答问题、提供信息、协助完成各种任务。有什么我可以帮助您的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 28,
    "total_tokens": 40
  }
}

关键字段说明:

choices[0].message.content - AI生成的回复内容
usage.total_tokens - 本次请求消耗的token数量
finish_reason - 停止原因（stop表示正常完成）

🎯 下一步

探索更多功能

🖼️

图像生成

使用Imagen模型生成高质量图像

查看文档 →

🎬

视频生成

使用Veo模型创建视频内容

查看文档 →

🎵

音频生成

文本转语音和音乐生成

查看文档 →

🔢

向量嵌入

文本向量化用于语义搜索

查看文档 →

重要资源

可用模型 - 查看所有支持的AI模型和定价
错误处理 - 了解如何处理API错误
速率限制 - 了解API使用限制
安全最佳实践 - 保护您的API密钥和数据

💡 常见问题

如何获取免费额度？

新注册用户将获得免费试用额度。访问控制台查看您的当前额度。

支持哪些模型？

我们支持多个领先的AI模型:

对话: Gemini 2.5 Flash/Pro, GPT-4, Claude等
图像: Imagen 4.0, DALL-E 3, Stable Diffusion等
视频: Veo 3.0等
音频: Lyria, Text-to-Speech等

完整列表请查看可用模型页面。

如何计费？

我们按使用量计费，不同模型有不同的定价。具体价格请查看定价页面。

遇到错误怎么办？

检查API密钥是否正确
确认请求格式符合文档规范
查看错误处理文档了解常见错误
如仍有问题，请联系技术支持

🔐 安全提示

切勿在客户端暴露API密钥!

如果您在浏览器端使用API，请通过自己的后端服务器代理请求，而不是直接在前端调用。

推荐做法:


// ❌ 不要这样做 (前端直接调用)
fetch('https://aiapi.services/v1/chat/completions', {
  headers: {
    'Authorization': 'Bearer sk-your-secret-key'  // 密钥暴露!
  }
})
 
// ✅ 正确做法 (通过后端代理)
fetch('/api/chat', {  // 调用你自己的后端
  method: 'POST',
  body: JSON.stringify({ message: 'Hello' })
})

更多安全建议请查看安全最佳实践文档。

🎉 恭喜！ 您已经完成了快速开始教程。现在可以开始构建您的AI应用了！