nexusflow
在线

快速开始

从第一个请求开始，选择 OpenAI、Anthropic Messages 或 Gemini-compatible 协议，并理解什么时候切换到异步任务模式。

三协议同步
OpenAI、Anthropic、Gemini 兼容入口共用同一套模型。
异步任务
图像和视频统一走 `/v1/tasks` 提交与轮询。
生产流量
上线前同时看限流说明、错误码和监控页。

选择兼容协议

前提条件

1

安装 SDK

默认使用 OpenAI SDK。已有 Anthropic 或 Gemini 客户端时，可直接查看对应兼容协议文档。

Python
pip install openai
Node.js
npm install openai
2

配置 API

将 base_url 指向 nexusflow，使用统一 API Key 即可访问所有模型。

Base URLhttps://nexusflow.hk/v1
API Keysk-air-xxxxxxxx(获取密钥)
认证方式Authorization: Bearer {API_KEY}
3

发起对话请求

文本和推理模型优先走同步接口。以下示例使用 Qwen3.5 Plus。

from openai import OpenAI

client = OpenAI(
    api_key="sk-air-your-key",
    base_url="https://nexusflow.hk/v1",
)

response = client.chat.completions.create(
    model="qwen3.5-plus",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好，请介绍一下你自己。"}
    ],
    temperature=0.7,
    max_tokens=1000
)

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

接入异步任务

当你开始接入图像或视频生成时，推荐统一使用 /v1/tasks。这套链路更适合高时延模型、后台批量任务和高并发排队。

curl -X POST https://nexusflow.hk/v1/tasks \
  -H "Authorization: Bearer sk-air-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "黄昏城市海岸线，镜头缓慢推进，电影感自然光",
    "duration": 10,
    "resolution": "720P"
  }'

# 轮询任务状态
curl https://nexusflow.hk/v1/tasks/task_xxx \
  -H "Authorization: Bearer sk-air-your-key"

高并发接入建议

把聊天请求和多媒体任务拆到不同队列，避免互相争抢吞吐。
同一个 API Key 可用于 OpenAI、Anthropic Messages、Gemini-compatible 三类协议。
任务轮询建议 3-5 秒一次，并使用指数退避处理失败重试。
压测前先确认限流页中的 RPM / TPM 与并发策略。
提示
  • 将 model 参数替换为其他模型 ID 即可切换模型
  • 所有模型共用同一个 API Key，无需分别申请
  • OpenAI、Anthropic Messages、Gemini-compatible 三种协议共用同一套余额与用量记录
  • 支持流式输出，设置 stream: true 即可
  • 图像与视频建议通过 /v1/tasks 接入，避免同步阻塞

下一步