接口文档

接入地址（按模型类型选择端点）

• 文本对话：POST /api/v1/chat/completions
• 图片生成：POST /api/v1/images/generations
• 视频生成：POST /api/v1/videos/generations
• 语音音频：POST /api/v1/audio/generations
• PPT生成：POST /api/v1/ppt/generations
• 向量嵌入：POST /api/v1/embeddings
• 模型列表：GET /api/v1/models

全部兼容 OpenAI 协议风格。模型卡片详情页会显示该模型对应的调用端点。

认证方式

请求头携带 Authorization: Bearer 你的API密钥，密钥在用户中心「API密钥」页面创建。

文本对话请求示例

```json

{

"model": "模型ID",

"messages": [{"role": "user", "content": "你好"}],

"stream": false

}

```

图片生成请求示例

```json

{

"model": "绘图模型ID",

"prompt": "一只在星空下奔跑的猫",

"n": 1,

"size": "1024x1024"

}

```

PPT生成请求示例

```json

{

"model": "beidouppt",

"prompt": "为北斗AI开放平台生成一份产品介绍PPT，包含平台优势、核心能力、应用场景和未来规划，页数8页左右",

"size": "16:9",

"n": 1

}

参数说明：

| 参数 | 类型 | 必填 | 说明 |

|----|----|----|----|

| model | string | 是 | 固定值 beidouppt |

| prompt | string | 是 | PPT 主题或详细需求描述 |

| size | string | 否 | 页面比例，支持 16:9（默认）、4:3 |

| n | integer | 否 | 生成份数，默认 1，最大 5 |

成功响应：

```json

{

"created": 1700000000,

"data": [

{

"url": "https://yourdomain.com/download_ppt.php?file=beidou_ppt_20260121_123456_9f3a2c1d.zip "

}

]

}

计费说明

• 对话/嵌入模型：按 tokens 计费，输入、输出、缓存命中 tokens 分别按每 1000 tokens 单价结算；
• 图片生成：按张计费（元/张），数量取请求中的 n；
• 视频/语音：按条计费（元/条）；
• PPT生成：按份计费（元/份）；
• 调用成功后从账户余额自动扣除，余额不足返回 402 错误。

cURL 示例

curl https://ai.beidouidc.cn/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-bd你的密钥" \
  -d '{"model":"模型ID","messages":[{"role":"user","content":"你好"}]}'

Python 示例（OpenAI SDK）

from openai import OpenAI
client = OpenAI(api_key="sk-bd你的密钥", base_url="https://ai.beidouidc.cn/api/v1")
resp = client.chat.completions.create(model="模型ID",
    messages=[{"role":"user","content":"你好"}])
print(resp.choices[0].message.content)