概述

入门指南

首次成功请求EmpirioLabs AI API

使用本指南，在一分钟内从新的API密钥到可用的聊天完成。

基础网址

https://api.empiriolabs.ai

所有端点都位于/v1/路径前缀下。

前提条件

在开始之前，请确保你具备：

  • EmpirioLabs的账户[empiriolabs.ai/get-started]（https://empiriolabs.ai/get-started）
  • 账户上的预付积分（通过仪表盘计费页面充值）
  • 来自仪表盘的API密钥（密钥使用sk-empiriolabs-前缀）
  • 一个用于发送HTTPS请求的工具，如cURL、Postman或OpenAI SDK。

快速入门

1

导出您的 API 密钥

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
2

列出可用的模型

$curl "https://api.empiriolabs.ai/v1/models" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

响应返回完整的模型目录，包含每个模型的定价、上下文窗口、区域和参数元数据。筛选出仅有有?available=true的型号。

3

发送聊天补全

$curl "https://api.empiriolabs.ai/v1/chat/completions" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "model": "qwen3-max",
>    "messages": [
>      { "role": "user", "content": "What is EmpirioLabs AI?" }
>    ]
>  }'

成功的响应会返回一个聊天完成对象，包含模型的回复、令牌使用次数和成本元数据。

4

试试OpenAI SDK

由于/v1/chat/completions端点兼容OpenAI，你可以指向EmpirioLabs的官方OpenAI SDK：

1from openai import OpenAI
2
3client = OpenAI(
4    api_key="sk-empiriolabs-your_key_here",
5    base_url="https://api.empiriolabs.ai/v1",
6)
7
8response = client.chat.completions.create(
9    model="qwen3-max",
10    messages=[{"role": "user", "content": "Hello from EmpirioLabs!"}],
11)
12
13print(response.choices[0].message.content)

接下来要探索什么

  • [认证]（/认证） - API 密钥格式、持有令牌和错误代码
  • [车型与定价]（/models-pricing） - - 浏览目录并理解定价单位
  • [兼容性]（/兼容性） - - 改用Responses或Anthropic Messages端点
  • [集成]（/integrations） - 将EmpirioLabs连接到OpenCode、Claude Code、Cline、Aider、Continue及其他编码工具
  • [API 参考]（/api-reference） - - 完整的请求和响应模式