curl で API を呼び出す

curl で API を呼び出す

このガイドを読み終えると、curl コマンドでチャット呼び出しができます。本サイトの API は OpenAI 互換です。完全なパラメータ説明は OpenAI 公式ドキュメントを参照してください。

リクエスト

curl https://api.tvtapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "system", "content": "あなたは役立つアシスタントです"},
      {"role": "user", "content": "こんにちは"}
    ]
  }'

3 箇所を置換:

  1. sk-xxxxxxxx → あなたの API Key
  2. your-model-name → モデル広場からコピーしたモデル名
  3. こんにちは → 送信したい内容

レスポンス

正常な JSON が返り、モデルの応答は choices[0].message.content にあります。

よく使うパラメータ

  • temperature:ランダム性。0 が最も安定、1 が最も創造的
  • max_tokens:応答の最大長を制限
  • stream:true でストリーミング出力、応答が順次返される

問題が発生した場合

  • 401:Key が間違い。エラーコード説明を参照。
  • 429:リクエストが多すぎます。後で再試行してください。
  • 長時間応答なし:ネットワークを確認。Base URL が https://api.tvtapi.com/v1 であることを確認。