接入指南

本平台的对话与外围能力接口 OpenAI 兼容：现有 OpenAI SDK 与绝大多数兼容工具，只需修改 base_url 和 api_key 即可接入。

通用配置

配置项	值
Base URL	https://confluia.com/v1（替换为你的真实 API 地址）
认证头	Authorization: Bearer sk-你的密钥

直接调用（curl）

curl https://confluia.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://confluia.com/v1",  # 替换为你的 API 地址
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

流式输出：

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://confluia.com/v1", // 替换为你的 API 地址
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

Anthropic 官方 SDK

import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://confluia.com",  # Claude 格式使用根地址，不要带 /v1
)
resp = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)

端点细节与认证方式差异见对话补全与认证与 API Key。

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o",
    api_key="sk-你的密钥",
    base_url="https://confluia.com/v1",
)

异步任务（视频生成等）

视频生成是异步任务：提交接口只返回 task_id，需要轮询查询接口直到 completed / failed，再获取成片地址。完整说明见视频生成。

import time
import requests

BASE, KEY = "https://confluia.com", "sk-你的密钥"
headers = {"Authorization": f"Bearer {KEY}"}

# 1. 提交任务（异步：立即返回 task_id）
task_id = requests.post(f"{BASE}/v1/videos", headers=headers, json={
    "model": "MiniMax-H3",
    "prompt": "一只猫在舞台上弹钢琴，聚光灯打在身上",
    "size": "1280x720",
    "duration": 4,
}, timeout=60).json()["task_id"]

# 2. 轮询任务状态（建议间隔 5~15 秒）
while True:
    data = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers, timeout=60).json()
    if data["status"] in ("completed", "failed"):
        break
    time.sleep(10)

# 3. 获取结果
print(data.get("metadata", {}).get("url") or data.get("error"))

官方 openai SDK 自 2.2.0（2025 年 10 月）起提供 client.videos.create / retrieve / download_content 资源；更早版本没有该资源（会报 AttributeError），请使用上面的 HTTP 调用方式。

流式、工具调用与多模态

• 流式：stream: true，SSE 事件格式与 OpenAI 一致（示例见上文 Python 段）。
• 工具调用（Function Calling）：tools / tool_choice 按 OpenAI 规范传递；各模型的工具调用能力不同，以 GET /v1/models 与实测为准。
• 多模态输入：图片、音频等以 OpenAI 的 content 数组形式传入（如 {"type": "image_url", "image_url": {"url": "..."}}），网关会自动转换为对应模型的原生协议。
• 图像 / 语音 / 视频：分别见图像生成、语音接口、视频生成。

其他 OpenAI 兼容工具

任何支持自定义 base_url / baseURL 与 API Key 的工具（各类 Chat 客户端、代码补全插件、自动化脚本等），统一按下表配置：

配置项	值
Base URL / 接口地址	https://confluia.com/v1
API Key	sk-你的密钥

网关协议兼容 OpenAI 官方规范；个别工具对流式格式或工具调用字段的实现若有差异，以对话补全中描述的接口行为为准。