API Stack 接続ドキュメント
アプリ接続、最初のリクエスト、プロトコルの確認。導入前に現在のモデルと料金を確認してください。
Tạo API Key
Lấy khoá bảo mật dạng sk-stk-... từ ví tài khoản để xác thực các request.
Chọn Base URL
Dùng https://apistack.vn cho Anthropic / Claude Code hoặc https://apistack.vn/v1 cho OpenAI SDK.
Chạy thử Request
Sao chép mã cURL hoặc mẫu Python / Node.js bên dưới để nhận phản hồi AI tức thì.
Xem mã mẫu ↓クイックスタート
例に必要なライブラリと対応ランタイムを用意し、環境変数 API_KEY を設定してください。例のモデルを、利用可能でプロトコルに合うものに置き換えてください。
SDK の準備と API キーの確認
使用言語に対応するライブラリをインストールします。Bash または PowerShell でキーを非表示入力し、GET /v1/models を呼び出して認証とモデル ID を確認します。このリクエストは AI コンテンツを生成しません。
read -r -s -p "API_KEY: " API_KEY
export API_KEY
printf '\n'
curl -fsS https://apistack.vn/v1/models -H "Authorization: Bearer ${API_KEY:?API_KEY}"cURL の例は macOS/Linux の Bash または WSL/Git Bash 向けです。API_KEY が未設定の場合、Python はキーの入力を求めます。Node.js は環境変数から読み取ります。
curl -N https://apistack.vn/v1/messages \
-H "x-api-key: ${API_KEY:?Hãy đặt 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 をインストールし、API Stack を実行してウィザードにキーを入力します。設定確認には API Stack doctor を使用します。チャットや ping のリクエストにも料金が発生する場合があります。
# Windows・macOS・Linux共通の推奨方法:Node.js >= 18 が必要
npm install -g API CLI@latest
# 代替インストーラー:npm、失敗時はGitHub + Bun:
# curl -fsSL "https://apistack.vn/install/api-cli.sh" | bash
# インストールのみ、設定ウィザードを開かない:
# curl -fsSL "https://apistack.vn/install/api-cli.sh" | API_CLI_NO_RUN=1 bash
API Stackアプリを接続
ツールとプロトコルから手順を探します。
Claude Code:ターミナルで API キー、モデル、接続先を設定します。
Codex CLI:ターミナルで API キー、モデル、接続先を設定します。
OpenClaw:ターミナルで API キー、モデル、接続先を設定します。
Hermes Agent:ターミナルで API キー、モデル、接続先を設定します。
リクエストのライフサイクル
API リクエストから精算まで
例に従って endpoint、モデル、ペイロードを送信します。API キーは環境変数またはサーバーのシークレット設定で管理してください。
各手順を選択すると詳細が表示されます。この図は処理の説明であり、実際のリクエスト状況は表示しません。
ベース URL
SDK とプロトコルに合う URL を選択。
Anthropic https://apistack.vn
OpenAI https://apistack.vn/v1
認証
キーを保護し適切なヘッダーを使用。
詳しいガイドを見るエンドポイントとプロトコル
モデルの機能に合うエンドポイントを選択。
詳しいガイドを見る画像・音声・動画
形式とジョブの状態遷移を確認。
詳しいガイドを見るストリーミング
イベント、使用量、最終エラーを処理。
詳しいガイドを見る料金
トークン、リクエスト、最低料金を理解。
一部のモデルには呼び出しごとの最低料金があります。短いリクエストにも適用される場合があり、トークン数が少なくても無料とは限りません。
詳しいガイドを見るエラーと再試行
エラーとリクエスト ID で調査。
x-api-request-id があればエラー時刻とともに保存してください。報告に API キーや機密データを含めないでください。
詳しいガイドを見る制限とタイムアウト
受付制限とタイムアウトを理解。
詳しいガイドを見る画像の生成と編集
画像生成、参照画像、結果の処理、料金の JSON ガイドです。
詳しいガイドを見る動画生成
Videos APIでテキストや画像から動画を生成し、進捗確認とMP4取得を行います。
詳しいガイドを見る画像認識
形式とジョブの状態遷移を確認。
詳しいガイドを見るレスポンスタイトル
x-api-request-id があればエラー時刻とともに保存してください。報告に API キーや機密データを含めないでください。
詳しいガイドを見るトラブルシューティング
Retry-After を守り、ジッター付き指数バックオフで回数と合計時間を制限してください。動画ジョブが作成済みの可能性がある場合は、再送前に ID で照会してください。
詳しいガイドを見る例はソース確認とローカル検証の対象であり、全アプリバージョンの実機検証を意味しません。実運用前に設定、小さなリクエスト、使用量を確認してください。