翻译快速开始

本指南将带您对 Shisa 翻译执行第一次翻译。您需要一个 API 密钥 — 请在 Shisa 平台创建。新账户包含 10 美元的免费额度。

1. 获取您的 API 密钥

Authorization: Bearer YOUR_API_KEY

备注

翻译使用标准的 bearer 令牌进行认证 — Authorization: Bearer YOUR_API_KEY。Shisa API 密钥以 shsk: 开头，请传入完整密钥。缺失或格式错误的 token 将返回 401 错误。完整的约定请参阅认证。

提示

请勿将 API 密钥纳入源代码管理。在实际应用中，应从环境变量（例如 SHISA_API_KEY）读取。

2. 发起请求

请求为 multipart/form-data — 将 text、source_lang 和 target_lang 作为表单字段发送。将 stream 设置为 "false" 可获得单个 JSON 响应。

curl

curl -X POST "https://api.shisa.ai/translate/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text=今日は素晴らしい天気ですね。" \
  -F "source_lang=ja" \
  -F "target_lang=en" \
  -F "stream=false"

Python

import requests

def translate_text(text, source_lang="ja", target_lang="en"):
    response = requests.post(
        "https://api.shisa.ai/translate/",
        headers={
            "Authorization": "Bearer YOUR_API_KEY"
        },
        data={
            "text": text,
            "source_lang": source_lang,
            "target_lang": target_lang,
            "stream": "false"
        }
    )
    return response.json()

# Example usage
result = translate_text("ビジネスの成功をお祈りします。")
print(result["choices"][0]["message"]["content"])

JavaScript

const translateText = async (text, sourceLang = 'ja', targetLang = 'en') => {
  const formData = new FormData();
  formData.append('text', text);
  formData.append('source_lang', sourceLang);
  formData.append('target_lang', targetLang);
  formData.append('stream', 'false');

  const response = await fetch('https://api.shisa.ai/translate/', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
    body: formData,
  });

  const data = await response.json();
  return data.choices[0].message.content;
};

// Example usage
const translation = await translateText('日本とアメリカの架け橋になる');
console.log(translation); // Returns translated text

3. 读取响应

API 返回 OpenAI 风格的 JSON 响应。翻译后的文本位于 choices[0].message.content：

{
  "id": "trans_20f537a6-da14-4c98-8ee3-063319c45072",
  "object": "translation.completion",
  "created": 1768299459,
  "model": "shisa-ai/chotto",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "お腹が空いた。"
      },
      "finish_reason": "stop"
    }
  ],
  "transcription": "I am hungry",
  "source_lang": "en",
  "target_lang": "ja",
  "balance": {
    "free": 1000,
    "premium": 0
  },
  "usage": {
    "prompt_tokens": 3,
    "completion_tokens": 1,
    "total_tokens": 4
  }
}

将 stream 设置为 "true" 可改为以 Server-Sent Events 形式接收翻译 — 有关包括流式格式在内的完整请求和响应模式，请参阅 API 参考。

后续步骤

在 API 参考中查看每个表单字段和响应字段。
在认证中了解各服务的认证标头约定。
在定价中了解用量如何计费。

1. ​获取​您​的​ A​PI 密钥​

2. ​发起​请​求​

3.​ ​读​取响​应​

后续​步​骤​

1. 获取您的 API 密钥

2. 发起请求

3. 读取响应

后续步骤