ユニバーサルパラメータ

認証

すべてのエンドポイントには Airforce API キーが必要です。ダッシュボードで生成します。 APIキー. キーは次で始まります sk-air-.

例

# Standard
curl https://api.airforce/v1/chat/completions \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  …

# Anthropic SDK style (only on /v1/messages, /v1/responses)
curl https://api.airforce/v1/messages \
  -H "x-api-key: sk-air-YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  …

# Multipart upload (file endpoints)
curl https://api.airforce/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "[email protected]" \
  -F "model=whisper-1"

オプションのリクエストヘッダー

応答ヘッダー

推論と思考 (クロスエンドポイント)

搭載モデル supports_reasoning: true 出現するすべての場所で同じ正規パラメータを受け入れます (現在、 /v1/chat/completions そして /v1/messages).

見る チャット完了 → 推論 完全な例については、

ストリーミング規約

受け入れるエンドポイント stream: true と応答します Content-Type: text/event-stream そしてサーバー送信イベントを発行します。ワイヤ形式はエンドポイントによって異なります。

エラーエンベロープ

すべてのエラー応答は同じ JSON 形式を使用します。 HTTP ステータス コードは失敗クラスを反映します。

{
  "error": {
    "message": "Model 'gpt-99' not found.",
    "type": "invalid_request",
    "param": "model",
    "code": "model_not_found"
  }
}

レート制限と再試行

制限は API キーごとに適用されます。いずれかを超えると返却される 429:

• Per-second request throttle (plan-dependent).
• Daily token cap on free / pay-as-you-go plans.
• ダッシュボードで設定したキーごとのクレジット上限。
• Concurrent video tasks (typically 4 in flight).

Retry with exponential backoff on 429 and 503. Don't retry on 4xx other than 429.

べき等性

生成エンドポイント (チャット、画像、オーディオ、ビデオ) は冪等ではありません。各呼び出しは新しい応答を生成し、個別に請求されます。決定的な結果を得るには、サポートされている場合 (画像、音声、一部のチャット モデル) に固定シードを設定します。長時間実行される非同期エンドポイント (/v1/video/generations) は、安全に再ポーリングできる task_id を返します。

エンドポイントマップ

すべてのパブリック エンドポイントの概要。