Python 快速入门¶

本指南帮助你在 3 分钟内完成 Python 环境配置并调用第一次 API。

准备工作¶

获取 API Key¶

登录 API Nexus 控制台，在密钥管理页面获取你的 API Key。格式为 nxk-xxxxxxxxxxxxxxxx。

安装依赖¶

API Nexus 兼容 OpenAI 官方 SDK，无需额外安装：

pip install openai

第一次 API 调用¶

from openai import OpenAI

client = OpenAI(
    api_key="nxk-你的真实APIKey",
    base_url="https://apinexus.net/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini-2024-07-18",
    messages=[{"role": "user", "content": "你好，请介绍一下你自己"}],
)

print(response.choices[0].message.content)

核心调用模式¶

文本对话¶

response = client.chat.completions.create(
    model="gpt-4o-mini-2024-07-18",
    messages=[
        {"role": "system", "content": "你是一位友善的助手"},
        {"role": "user", "content": "什么是大语言模型？"},
    ],
    max_tokens=500,
)
print(response.choices[0].message.content)

流式输出¶

stream = client.chat.completions.create(
    model="gpt-4o-mini-2024-07-18",
    messages=[{"role": "user", "content": "写一首关于AI的诗"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Embedding 向量¶

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="要向量化的文本内容",
)

embedding_vector = response.data[0].embedding
print(f"向量维度: {len(embedding_vector)}")

图像生成¶

response = client.images.generate(
    model="doubao-seedream-4-0-250828",
    prompt="一只可爱的卡通小猫",
    size="1024x1024",
    n=1,
)
print(f"图片URL: {response.data[0].url}")

语音合成¶

response = client.audio.speech.create(
    model="gpt-4o-mini-tts",
    voice="alloy",
    input="你好，欢迎使用API Nexus服务！",
)

with open("output.mp3", "wb") as f:
    f.write(response.content)

模型选择¶

场景	推荐模型	特点
日常对话	gpt-4o-mini-2024-07-18	速度快，成本低
精确推理	gpt-4o-2024-08-06	能力更强
中文优化	deepseek-v3-250528	中文理解好
图像生成	doubao-seedream-4-0-250828	写实风格
图像生成	flux-schnell	生成速度快
文本向量	text-embedding-3-small	1536维，速度快
文本向量	text-embedding-3-large	3072维，精度高
语音合成	gpt-4o-mini-tts	语音自然流畅

错误处理¶

from openai import APIError, APIConnectionError, RateLimitError

try:
    response = client.chat.completions.create(
        model="gpt-4o-mini-2024-07-18",
        messages=[{"role": "user", "content": "你好"}],
    )
except RateLimitError:
    print("请求频率超限，请稍后重试")
except APIConnectionError:
    print("网络连接失败，请检查网络设置")
except APIError as e:
    print(f"API错误: {e}")

下一步学习¶

教程内容	链接
文本对话进阶	详细教程
图像生成指南	详细教程
Embedding 使用	详细教程
语音合成实战	详细教程
多模态识图	详细教程

返回 Python 教程概览