接入文档

OpenAI 兼容协议 —— 已有 OpenAI SDK 的项目只需改 base_url 和 api_key。

1. 获取 API Key

打开用户控制台创建 Key（形如 sk-…），请妥善保存，只显示一次。

2. 文本对话

curl https://ai.joydove.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","messages":[{"role":"user","content":"你好"}]}'

Python：OpenAI(base_url="https://ai.joydove.cn/v1", api_key="sk-…")；模型名从模型广场取，全部同价可用。

3. 其他模态

能力	端点	说明
图片生成	POST /v1/images/generations	OpenAI 图片协议
视频生成	POST /v1/videos	异步任务，轮询 /v1/videos/{id}
语音合成	POST /v1/audio/speech	OpenAI 语音协议
语音识别	POST /v1/audio/transcriptions	上传音频文件
3D 生成	POST /v1/3d/generations	异步任务，取件 /content
实时语音	wss://ai.joydove.cn/v1/realtime?model=…	WebSocket 双向流式
重排	POST /v1/rerank	文档重排

4. 模型列表

curl https://ai.joydove.cn/v1/models -H "Authorization: Bearer sk-你的Key"

用量与账单在控制台查看；所有请求都可在控制台的用量日志里审计。