開発者ドキュメント · API V1

API Stack 接続ドキュメント

アプリ接続、最初のリクエスト、プロトコルの確認。導入前に現在のモデルと料金を確認してください。

1

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.

Mở Quản lý Key →
2

Chọn Base URL

Dùng https://apistack.vn cho Anthropic / Claude Code hoặc https://apistack.vn/v1 cho OpenAI SDK.

Xem chi tiết URL →
3

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
詳しいガイドを見る

アプリを接続

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

← すべてのアプリ

リクエストのライフサイクル

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 で照会してください。

詳しいガイドを見る

例はソース確認とローカル検証の対象であり、全アプリバージョンの実機検証を意味しません。実運用前に設定、小さなリクエスト、使用量を確認してください。

Support