开发文档

快速接入 API 服务,5 分钟完成集成

快速开始

欢迎使用黔前智算 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 流式输出,适合实时对话场景。