メインコンテンツまでスキップ

翻訳クイックスタート

この​ガイドでは、​Shisa 翻訳に​対して​最初の​翻訳を​実行します。​API キーが​必要です — Shisa プラットフォーム で​作成してください。​新規アカウントには​ 10ドル分の​無料クレジット が​含まれます。

1. API キーを​取得する​

Shisa AI アカウントに​サインアップし、Shisa プラットフォーム から​ API キーを​取得します。Authorization ヘッダーに​含めてください。

Authorization: shsk:YOUR_API_KEY
注記

翻訳では​翻訳専用の​認証ヘッダーを​使用します。​トークンは​ そのまま 送信します — Authorization: shsk:YOUR_API_KEY のように、Bearer プレフィックスは​ 付けません。​これは​他の​ Shisa サービスとは​異なり、​トークンが​欠落または​不正な​形式の​場合は​ 401 エラーが​返されます。​完全な​規約に​ついては​ 認証 を​参照してください。

ヒント

API キーを​ソース管理の​外に​保ってください。​実際の​アプリケーションでは、​環境変数​（例: SHISA_API_KEY）から​読み込みます。

2. リクエストを​送信する​

リクエストは​ multipart/form-data です — text、source_lang、target_lang を​フォームフィールドとして​送信します。​単一の​ JSON レスポンスを​得るには​ stream を​ "false" に​設定します。

curl
curl -X POST "https://api.shisa.ai/translate/" \
  -H "Authorization: shsk: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": "shsk: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': 'shsk: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
  }
}

代わりに​翻訳を​ Server-Sent Events と​して​受け取るには​ stream を​ "true" に​設定します — ストリーミング形式を​含む完全な​リクエストおよび​レスポンススキーマに​ついては​ API リファレンス を​参照してください。

次の​ステップ​

  • すべての​フォームフィールドと​レスポンスフィールドを​ API リファレンス で​確認します。
  • サービス全体の​認証ヘッダー規約を​ 認証 で​学びます。
  • 利用が​どのように​課金されるかを​ 価格 で​確認します。