Lumi API 接入文档

统一的 AI 模型聚合与分发网关，支持多种大语言模型、视频生成等服务。

基本信息

项目	值
API Base URL	https://api.heang.top/v1
端点格式	OpenAI 兼容
认证方式	Bearer Token

获取 API Key

1. 访问 https://api.heang.top
2. 注册/登录账号
3. 进入「控制台」→「令牌管理」
4. 创建新令牌，获取 sk-xxx 格式的 API Key

---

API 端点

Chat 补全

POST https://api.heang.top/v1/chat/completions

请求示例：

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "你好"}
  ],
  "stream": true
}

Embeddings

POST https://api.heang.top/v1/embeddings

图片生成

POST https://api.heang.top/v1/images/generations

音频生成

POST https://api.heang.top/v1/audio/speech

视频生成

POST https://api.heang.top/v1/video/generations

模型列表

GET https://api.heang.top/v1/models

---

代码示例

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.heang.top/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)

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

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.heang.top/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '你好' }],
  stream: true
});

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

curl

curl https://api.heang.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

---

视频生成 (Seedance 2.0)

支持的模型

模型 ID	说明
doubao-seedance-2-0-260128	Seedance 2.0 标准版
doubao-seedance-2-0-fast-260128	Seedance 2.0 快速版

参数说明

参数	类型	说明	默认值
content	array	输入内容（文本/图片/视频/音频）	必填
ratio	string	视频比例：16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive	16:9
duration	int	视频时长（5-30秒）	10
resolution	string	分辨率：480p, 720p, 1080p	720p
generate_audio	bool	是否生成音频	true

请求示例

curl https://api.heang.top/v1/video/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [{"type": "text", "text": "一只可爱的猫咪在草地上奔跑"}],
    "ratio": "16:9",
    "duration": 10,
    "resolution": "720p",
    "generate_audio": true
  }'

图生视频示例

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {"type": "text", "text": "猫咪开始奔跑"},
    {"type": "image_url", "image_url": {"url": "https://example.com/cat.jpg"}, "role": "reference_image"}
  ],
  "ratio": "16:9",
  "duration": 10
}

查询任务状态

curl https://api.heang.top/v1/video/generations/{task_id} \
  -H "Authorization: Bearer sk-your-api-key"

---

错误码

状态码	说明
200	成功
400	请求参数错误
401	API Key 无效或未提供
402	余额不足
404	模型或端点不存在
429	请求频率超限
500	服务器内部错误

---

技术支持

• 控制台：https://api.heang.top
• 文档：https://docs.heang.top
• Lumi API 基于 NewAPI 开源项目构建