DOCUMENTATION

接入文档

5 分钟接入 70+ AI 模型，兼容 OpenAI API 格式，国内直连无需代理。

快速接入

棱镜AI 完全兼容 OpenAI API 格式。只需修改 base_url，无需改动任何业务代码。

🐍 Python · OpenAI SDK
Python
1from openai import OpenAI
2
3client = OpenAI(
4 api_key="sk-prysm-xxxxxxxx", # 棱镜AI Key
5 base_url="https://api.prysm-ai.com/v1", # ← 只改这里
6)
7
8response = client.chat.completions.create(
9 model="gpt-5.4-mini",
10 messages=[{"role": "user", "content": "你好"}],
11)
12print(response.choices[0].message.content)
⚡ JavaScript · OpenAI SDK
JavaScript
1import OpenAI from "openai";
2
3const client = new OpenAI({
4 apiKey: "sk-prysm-xxxxxxxx",
5 baseURL: "https://api.prysm-ai.com/v1",
6});
7
8const resp = await client.chat.completions.create({
9 model: "claude-sonnet-4-6",
10 messages: [{ role: "user", content: "Hello!" }],
11});
12console.log(resp.choices[0].message.content);
💻 curl
Shell
1curl https://api.prysm-ai.com/v1/chat/completions \
2 -H "Authorization: Bearer sk-prysm-xxxxxxxx" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "deepseek/deepseek-v3.2",
6 "messages": [{"role": "user", "content": "用 Python 写快排"}]
7 }'

配置开发工具

Claude Code
  1. 打开终端，输入 claude，按 S 进入设置
  2. 选择 API Configuration
  3. 将 base_url 改为 https://api.prysm-ai.com
  4. 填入你的棱镜AI Key，保存即可
Claude Code 默认支持切换 API endpoint，无需插件。
Cursor
  1. 打开 Cursor 设置（Cmd/Ctrl + ,）
  2. 找到 OpenAI API Key 和 Base URL 设置
  3. 填入棱镜AI Key 和 https://api.prysm-ai.com/v1
Cline / Continue / Aider
  1. 在插件设置中找到 API Base URL
  2. 改为 https://api.prysm-ai.com/v1
  3. 填入棱镜AI Key
  4. 模型选择任意支持的模型 ID 即可

图像生成

图像生成使用专用接口，返回图片 URL（有效期 24 小时）。

🐍 生成图像
Python
1import requests
2
3resp = requests.post(
4 "https://api.prysm-ai.com/volcengine/api/v3/images/generations",
5 headers={"Authorization": "Bearer sk-prysm-xxxxxxxx"},
6 json={
7 "model": "doubao-seedream-5-0-lite",
8 "prompt": "一只在咖啡馆里读书的橘猫，丁达尔光效，胶片质感",
9 "size": "1024x1024",
10 }
11)
12print(resp.json()["data"][0]["url"])

视频生成（异步）

视频生成为异步任务：先提交任务获取 task_id，再轮询直到完成。

🐍 视频生成完整示例
Python
1import requests, time
2
3BASE = "https://api.prysm-ai.com"
4KEY = "sk-prysm-xxxxxxxx"
5HDR = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}
6
7# 1. 提交任务
8resp = requests.post(
9 f"{BASE}/kling/v1/videos/generations",
10 headers=HDR,
11 json={
12 "model": "kling-v3",
13 "prompt": "一只海豚跃出海面，慢动作，超高清",
14 "duration": 5, # 5 秒
15 }
16)
17task_id = resp.json()["data"]["task_id"]
18print(f"Task ID: {task_id}")
19
20# 2. 轮询状态（每 15 秒）
21while True:
22 status = requests.get(
23 f"{BASE}/kling/v1/videos/generations/{task_id}",
24 headers=HDR
25 ).json()["data"]
26
27 state = status["task_status"]
28 print(f"状态: {state}")
29
30 if state == "SUCCEEDED":
31 url = status["task_result"]["videos"][0]["url"]
32 print(f"视频地址: {url}")
33 break
34 elif state in ("FAILED", "CANCELED"):
35 print("任务失败:", status.get("message"))
36 break
37
38 time.sleep(15) # 等 15 秒再查
⚠️ task_id 有效期 24 小时，视频 URL 有效期 7 天，请及时下载保存。

模型 ID 参考

常用模型 ID 速查：

gpt-5.4OpenAI文本
gpt-5.4-miniOpenAI文本
claude-opus-4-7Anthropic文本
claude-sonnet-4-6Anthropic文本
gemini-2.5-proGoogle文本
deepseek/deepseek-v3.2DeepSeek文本
doubao-seedream-5-0-lite字节跳动图像
kling-v3快手视频（异步）
sora-2-proOpenAI视频（异步）
speech-2.8-hdMiniMax语音

常见错误处理

401
Unauthorized
API Key 无效或已过期。检查 Key 格式是否正确，以 sk-prysm- 开头。
402
Payment Required
账户余额不足。前往控制台 → 账单充值。
429
Too Many Requests
请求频率超限。默认限制 60 RPM，请在代码中添加指数退避重试。
503
Service Unavailable
上游服务暂时不可用。通常 1-2 分钟内恢复，建议添加重试逻辑。