1. 准备密钥和模型
打开 ViVi-API 控制台,准备以下信息:- 一个有效的 ViVi-API API Key。
- 与所选接口协议匹配、且账号有权限使用的模型 ID。
- 足够的可用额度。
下文使用
YOUR_OPENAI_MODEL 作为占位符,不能直接发送。请替换为控制台中的完整模型 ID。其他两套协议分别使用 YOUR_GEMINI_MODEL 和 YOUR_ANTHROPIC_MODEL。2. 选择接口协议
所有地址均使用
https://api.viviai.cc 作为主机。Anthropic 示例还需发送 anthropic-version 请求头。
3. 设置环境变量
- macOS / Linux / Bash
- Windows PowerShell
4. 发送第一次请求
以下示例使用 OpenAI Chat 协议。cURL 示例使用 Bash 语法;Windows 可使用 Git Bash / WSL,或使用下面的 Python 示例。python -m pip install requests。收到成功响应后,OpenAI Chat 的文本结果通常位于 choices[0].message.content。
常见问题
具体原因以接口返回的错误正文为准。对超时请求重试前,应考虑原请求可能已经执行,避免重复调用和计费。
下一步
OpenAI Chat
SDK 接入、多轮对话与流式输出。
Gemini
contents、parts 和 SSE 流式调用。
Anthropic
Messages、system 与输出长度控制。