SDK

调用 Shisa 的方式取决于服务。Shisa LLM 与 OpenAI 兼容，因此你可以直接使用官方的 OpenAI SDK。ASR、TTS 和翻译没有专用的 SDK——你需使用标准 HTTP 客户端来调用它们。在任何情况下，都应将 API 密钥保存在环境变量中，而不要硬编码。

LLM — 使用 OpenAI SDK

Shisa LLM 使用 OpenAI Chat Completions API。安装官方 SDK，将基础 URL 指向 Shisa，并使用 Shisa 的模型名称。

# Python
pip install openai

# Node.js
npm install openai

将基础 URL 设置为 https://api.shisa.ai/openai/v1，并使用模型 shisa-ai/shisa-v2.1-llama3.3-70b：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.shisa.ai/openai/v1",
    api_key=os.environ["SHISA_API_KEY"],
)

response = client.chat.completions.create(
    model="shisa-ai/shisa-v2.1-llama3.3-70b",
    messages=[{"role": "user", "content": "日本語で自己紹介をしてください。"}],
)
print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.shisa.ai/openai/v1',
  apiKey: process.env.SHISA_API_KEY,
});

const response = await client.chat.completions.create({
  model: 'shisa-ai/shisa-v2.1-llama3.3-70b',
  messages: [{ role: 'user', content: '日本語で自己紹介をしてください。' }],
});
console.log(response.choices[0].message.content);

OpenAI SDK 还会为你处理流式传输和 429 时的重试。包含 curl 的完整演练请参见 LLM 快速入门。

ASR、TTS 和翻译 — 使用标准 HTTP 客户端

这些服务是普通的 HTTPS API，不在 OpenAI SDK 的覆盖范围内。请使用 Python 中的 requests 或 Node 中的 fetch——任何你已经在用的 HTTP 客户端——来调用它们。它们与 LLM API 使用相同的 Authorization: Bearer YOUR_API_KEY 请求头；请参见身份验证。

import os
import requests

response = requests.post(
    "https://api.shisa.ai/translate/",
    headers={"Authorization": f"Bearer {os.environ['SHISA_API_KEY']}"},
    json={"text": "Hello", "target": "ja"},
)
print(response.json())

const response = await fetch('https://api.shisa.ai/tts/voices', {
  headers: { Authorization: `Bearer ${process.env.SHISA_API_KEY}` },
});
const voices = await response.json();
console.log(voices);

有关请求和响应的详情，请从每项服务的快速入门开始：

语音识别（ASR） — 快速入门和端点参考。
Text-to-Speech（TTS） — 快速入门和端点参考。
翻译 — 快速入门和端点参考。

提示

无论你使用哪种客户端，都应从诸如 SHISA_API_KEY 的环境变量加载 API 密钥，而不要硬编码，并且切勿将其随客户端代码一起发布。请参见身份验证。

后续步骤

身份验证 — 各服务请求头约定。
错误 — 状态码和 JSON 错误结构。
速率限制 — 通过退避处理 429。

LLM — ​使用​ OpenAI SDK​

A​SR、​TT​S ​和​翻译​ — ​使用​标准​ HTTP ​客户​端​

后续​步​骤​

LLM — 使用 OpenAI SDK

ASR、TTS 和翻译 — 使用标准 HTTP 客户端

后续步骤