ThAPI 接続ドキュメント

クイックスタート

例に必要なライブラリと対応ランタイムを用意し、環境変数 STALI_API_KEY を設定してください。例のモデルを、利用可能でプロトコルに合うものに置き換えてください。

read -r -s -p "STALI_API_KEY: " STALI_API_KEY
export STALI_API_KEY
printf '\n'
curl -fsS https://thapi.cloud/v1/models -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}"

cURL の例は macOS/Linux の Bash または WSL/Git Bash 向けです。STALI_API_KEY が未設定の場合、Python はキーの入力を求めます。Node.js は環境変数から読み取ります。

curl -N https://thapi.cloud/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Viết hàm quicksort bằng Python" }
    ]
  }'

コンテンツ生成の例は実際のリクエストを送信するため、料金が発生する場合があります。実行前に課金単位とリクエストごとの最低料金を確認してください。

API CLI をインストール

Node.js 18 以降が必要です。API CLI をインストールし、thapi を実行してウィザードにキーを入力します。設定確認には api-cli doctor を使用します。チャットや ping のリクエストにも料金が発生する場合があります。

# Windows・macOS・Linux共通の推奨方法：Node.js >= 18 が必要
npm install -g stali-cli@latest

# 代替インストーラー：npm、失敗時はGitHub + Bun：
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | bash

# インストールのみ、設定ウィザードを開かない：
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | STALI_CLI_NO_RUN=1 bash

stali

アプリを接続

ツールとプロトコルから手順を探します。

画像の生成と編集

画像生成、参照画像、結果の処理、料金の JSON ガイドです。

動画生成

Videos APIでテキストや画像から動画を生成し、進捗確認とMP4取得を行います。

画像認識

形式とジョブの状態遷移を確認。

レスポンスタイトル

x-thapi-request-id があればエラー時刻とともに保存してください。報告に API キーや機密データを含めないでください。

トラブルシューティング

Retry-After を守り、ジッター付き指数バックオフで回数と合計時間を制限してください。動画ジョブが作成済みの可能性がある場合は、再送前に ID で照会してください。