快速开始
欢迎使用黔前智算 API!本文档将帮助您快速接入我们的服务。5 分钟完成集成,开始您的 AI 之旅。
1. 获取 API Key
首先,您需要注册账号并创建一个 API Key。登录后前往「控制台」-「API 密钥」页面创建。
1 注册账号并完成实名认证
2 进入控制台,点击「API 密钥」
3 点击「创建密钥」,复制 API Key
4 妥善保管 API Key,不要泄露给他人
2. 安装 SDK
我们提供多种语言的 SDK,您可以选择适合您项目的版本:
Python
Node.js
Java
Go
# 使用 pip 安装
pip install qqai
# 或使用 poetry
poetry add qqai
# 使用 npm 安装
npm install @qqai/sdk
# 或使用 yarn
yarn add @qqai/sdk
# 或使用 pnpm
pnpm add @qqai/sdk
<dependency>
<groupId>com.qqai</groupId>
<artifactId>qqai-sdk</artifactId>
<version>1.0.0</version>
</dependency>
// Gradle
implementation 'com.qqai:qqai-sdk:1.0.0'
// 使用 go get 安装
go get github.com/qqai/qqai-go-sdk
3. 代码示例
以下是最常用的 API 调用示例:
聊天完成
from qqai import Client
# 初始化客户端
client = Client(api_key="your-api-key")
# 创建聊天完成
response = client.chat.completions.create(
model="gpt-4",
messages=[
{"role": "system", "content": "你是一个 helpful assistant"},
{"role": "user", "content": "你好,请介绍一下自己"}
],
temperature=0.7,
max_tokens=1000
)
print(response.choices[0].message.content)
流式输出
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "讲一个故事"}],
stream=True
)
for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
图像生成
response = client.images.generate(
model="dall-e-3",
prompt="一只可爱的猫咪在草地上玩耍",
size="1024x1024",
quality="standard",
n=1
)
image_url = response.data[0].url
print(f"图像地址: {image_url}")
4. 支持的模型
| 模型名称 | 类型 | 上下文长度 | 特点 |
|---|---|---|---|
| gpt-4-turbo | 聊天 | 128K | 强大的推理和代码能力 |
| gpt-3.5-turbo | 聊天 | 16K | 高性价比,响应快速 |
| claude-3-opus | 聊天 | 200K | 顶级推理能力 |
| dall-e-3 | 图像 | - | 高质量图像生成 |
| whisper-1 | 语音 | - | 多语言语音识别 |
5. 常见问题
Q: API 支持哪些编程语言?
A: 我们提供 Python、Node.js、Java、Go、C#、PHP 等主流语言的 SDK,同时支持标准的 REST API,任何语言都可以调用。
Q: 如何查看 API 调用记录?
A: 登录控制台,进入「用量统计」页面,可以查看详细的 API 调用记录、token 消耗和费用明细。
Q: 是否支持流式输出?
A: 支持。在请求中设置 stream: true 即可启用 SSE 流式输出,适合实时对话场景。